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Intro duction 



About this Manual 



This manual explains how to remotely control the oscilloscope, using commands keyed into the external 
controller. This controller will normally be a computer, although it could be a simple terminal. 

The manual includes a complete list of the commands you'll need to perform most Waverunner opeiutions 
(you can find commands for a few special, optional functions in the software option's dedicated manual). The 
manual has two main parts: 

PartOne, "About Remote Control," covens the principles of remote control, and offers piuctical 
examples. 

Part Two, "Commands," describes each of the remote control commands and gueiies for Waverunner 
operations. It starts with two special indexes that list the commands by short name and by category. Use these 
to find the command or guery you wish to use. 

See also the table of contents and the index at the back of the manual. 

As an additional guide, each chapter is prefaced by a summary of its contents 

Watch for these icons and the information they signal: 




TIPs offer additional hints on how to get the most out of Waverunner actions or features 




NOTES bring to your attention important information you should know. 



See also Chapter 12, "Use Waverunner with PC," in the Operator's Manual. 



LTXXX-RCM-E Rev B 



I SSUE D : January 2002 



1 




BLANK PAGE 



2 



I SSUE D : January 2002 



LTXXX-RCM-E Rev B 




w 



Part One 

ABOUT 

REMOTE CONTROL 



Pait One of the manual explains how Waveninner operates under remote control. It covers GPIB and 
RS-232-C interfaces, the transfer and formatting of waveforms, and the use of status bytes in reporting 
errors. 
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Chapter One: Ovmdeiv 
In this ch^ter, see how 

To construct program messages 
To use commands and queries 
To include data, and make data strings 
To use ScopeExplorei® for remote control 
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Chapter One 



Ovemew 



OpeiBbe \\^nm]nner by Remote Conhol 

You can fully control your Waverunner oscilloscope remotely by using either the G PIB (G eneral Purpose 
Interface Bus) port or the RS-232-C communication port on the scope rear panel, shown below. The only 
actions for which you must use the front panel controls are the powering up of the scope and the setting of 
remote addresses. Use LeCroy's ScopeExplorer software as the ideal interface between scope and PC (see page 
11 ). 




Waverunner back panel, including the GPIB and RS-232-C ports used in remote control. 



TIP: Use Waverunner Remote Control Assistant to monitor all your rmmte control operations. See the 
COMM_HELP command in Part Two of tins manual, arid Ch^terl2of tiwOpemtofsManaal "Use 
Wtiverurmer with PC". 
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Part One: ABOUT REMOTE CONTROL 



STANDARDS 

LeCroy remote control commands conform to theGPIB IEEE 488.2* standard. This m^ be considered an 
extension of the IEEE 488.1 standard, which deals mainly with electrical and mechanical issues. The IEEE 
488.2 recommendations have also been adopted for RS-232-C communications wherever appropriate. 

PROGRAM MESSAGES 

You control the oscilloscope remotely using program messages that consist of one or several commands or 
gueries. The program messages you send from the external controller to the Waverunner oscilloscope must 
conform to precise format structures. The oscilloscope will execute all program messages sent in the correct 
form, but will ignore those with errors. 

You can use upper- or lower-case characters, or both, in program messages. 

Warning or error messages are normally not reported unless the controller explicitly examines the relevant status 
register, or if the status-enable registers have been set so that the controller can be interrupted when an error 
occurs. If you connect an external monitor to the Waverunner's RS-232-C port, however, you will be able to 
observe all your remote control transactions, including error messages, as they happen. See the command 
C0MM_HELP in Part Two, "Commands." 

Program messages are separated by semicolons ; and end in a terminator: 

<command/ guery>; ;<command/ guery> <terminator>. 

The oscilloscope will not decode an incoming program message before receiving its terminator. The exception is 
when the program message is longer than the 256 byte input buffer; then the oscilloscope will start analyzing the 
message when the buffer is full. Commands and gueries are executed in the order in wMch they are transmitted. 

In G PIB mode, the following are valid terminators: 

<NL> New-line character (i.e. the ASCII new-line character, whose decimal value is 10). 

<NLxEOI> New-line character with a simultaneous <EOI> signal. 

<E 0 1 ><E 0 1 > Signal together with the last character of the program message. 

The <NL> <EOI> terminator is alw^s used in response messages sent by the oscilloscope to the controller. 

In RS-232-C communications, you can define the terminator with the command comm_rs 2 32. The default 
value is <CR>, which is the A^II carriage return character, whose decimal value is 13. 




*ANSI/IEEE Std. 488.2-1987, IEEE Standaid Codes, Formats, Protocols, and Common Commands. The Institute of Electrical and Electronics Engineeis 
Inc., 345 East 47th Street, New York, NY 10017 USA. 
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Chapter One: Overview 



COMMANDS AND QUERIES 

Program messages are made up of one or more commands or queries. While the command directs the 
oscilloscope to change its state (for example, its timebase or vertical sensitivity) the query asks the oscilloscope 
about that state. Very often, you will use the same mnemonic for a command and a query, the query being 
identified by a ? after the last character. 

For example, to change the timebase to 2 ms/ div, send this command to the oscilloscope: 

TIME_DIV 2 M 

0 r, to ask the oscilloscope about its timebase, send this query: 

TIME_DIV? 

A query causes the oscilloscope to send a response message. The control program should read this message with 
a 'read' instruction to the G PIB or RS-232-C interface of the controller. 

The response message to the above query mi^t be: 

TIME_DIV 10 NS 

The portion of the query preceding the question mark is repeated as part of the re^onse message. If desired, 
this text can be suppressed with the command comm_header. 

Depending on the state of the oscilloscope and the computation to be done, several seconds may pass before a 
response is received. Command interpretation does not have priority over other oscilloscope activities. 

The general form of a command or a query consists of a command header, <header>, optionally followed by 
one or several parameters, <data>, separated by commas: 

<header>[?] <data>, ..., <data> 

The notation [?] shows that the question mark is optional (turning the command into a query). 

There is a space between the header and the first parameter. 

There are commas between parameters 



The following are examples of how program 
messages are made up of commands and queries.. 

GRID DUAL: This program message consists of a 
sin^e command that instructs the oscilloscope to 
display a dual grid. 

The terminator is not shown, as it is usually automatically added by the interface driver routine writing to G PIB 
or RS232. 

DZOM ON; DISPLAY OFF; DATE ? :This program message consists of two Commands, followed by a 
query. They instruct the oscilloscope to turn on the multi-zoom mode, turn off the displ^, and then ask for the 
current date. Again, the terminator is not shown. 

date 15, JAN, 1993, 13, 21, 1 6 : This command instructs the osdlloscope to set its date and time to 15 
JAN 1993, 13:21:16. The command header date indicates the action, the 6 data values ^edfy it in detail. 



TIP: Set the contmUerl/ O timeout conditions 
to three or more seconds to give the scope tune 
to respond Aninmrrectquerywillnotgeta 
response; and, if Remote Control Assistant is 
enabled, a beep wiU sound. 
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Part One: ABOUT REMOTE CONTROL 



HEADERS 

The header is the mnemonic form of the operation to be performed by the oscilloscope. Most command and 
query headers have a long form, which allows them to be read more easily, and a short form for better transfer 
and decoding speed. The two are fully equivalent and you can use them interchangeably. For example, 
TRiG_MODE AUTO and TRMD AUTO are two Separate but equivalent Commands for switching to the 
automatic trigger mode. 

Some command or query mnemonics are imposed by the IEEE 488.2 standard. They are standardized so that 
different oscilloscopes Ml present the same programming interface for similar functions. AU these mnemonics 
begin with an asterisk *. Eor example, the command *rst is the IEEE 488.2 imposed mnemonic for resetting 
the oscilloscope, whereas * t s t ? instructs the oscilloscope to perform an internal self- test and report the 
outcome. 

HEADER PATHS 

Certain commands or queries apply to a sub-section of the oscilloscope; for example, a sin^e input channel or a 
trace on the displ^. In such cases, you must prefix the header by a path name that indicates the channel or trace 
to which the command applies The header path normally consists of a two-letter path name followed by a 
colon : immediately preceding the command header. One of the waveform traces can usually be specified in the 
header path: 



Header Path Name 


Waveeorm Trace 


Cl, C2 


Channels 1 and 2 


C3, C4 


Channels 3 and 4 (on four-channel models) 


Ml, M2, M3, M4 


Memories 1, 2, and 3 and 4 


TA, TB, TC, TD 


Traces A, B, C and D 


EX, EXIO, EX5 


External trigger 


LINE 


LINE source for trigger 



Example: ciiOFSt -300 mv Command to set the offset of Channel 1 to -300 mV. 

You need only specify a header path once. Subsequent commands with header destinations not indicated are 
assumed to refer to the last defined path. Eor example, the queries C2 : vd iv? ; C2 : ofst? ask: What is the 
vertical sensitivity and the offset of channel 2? While the queries c 2 :VDIV?; ofst? ask exactly the same 
question without repeating the path. 
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Chapter One: Overview 



DATA 

Whenever a command or query uses additional data values, the values are expressed as ASCII characters. There 
is a single exception: the transfer of waveforms with the command/ query waveform, where the waveform can 
be expressed as a sequence of binary data values. See Chapter 4, "Waveform Structure." ASCII data can 
have the form of character, numeric, string, or block data 



CHARACTER DATA 

These are simple words or abbreviations to indicate a specific action. 

Example: dual_zoom on 

In this example, the data value on commands the dual zoom mode to be turned on (the data value off will 
have the opposite effect). 

However, this can become more complex. In some commands, where you can ^edfy as many as a dozen 
different parameters, or where not all the parameters are applicable at dre same time, the format requires pairs of 
data values. The first value names the parameter to be modified, while the second gives its value. 0 nly those 
parameter pairs changed need to be indicated. 

Example: hardcopy_setup dev, Epson, port, gpib 

In this example, two pairs of parameters have been used. The first specifies the device as an ep son (or 
compatible) printer, while the second indicates the GPIB port. While the command hardcopy_setup allows 
many more parameters, either they are not relevant for printers or they are left unchanged. 

NUMERIC DATA 

The numeric data type is used to enter quantitative information. Numbers can be entered as integers or 
fractions, or in exponential representation: 

TA : VP 0 s - 5 Move the displayed trace of Trace A downwards by five divisions. 

C2:OFST 3.5 6 Set the DC offset of Channel 2 to 3.56 V. 

TD IV 5 . OE- 6 Adjust the timebase to 5 psec/ div. 

Example: There are many w^s of setting the timebase of the oscilloscope to 5 psec/ div: 

TDiv 5E-6 Exponential notation, without any suffix. 

TDiv 5 us Suffix multiplier u for lE-6, with the (optional) suffix s for seconds, 

or 

TDIV 5000 NS 
TDIV 5000E-3 US 

You can follow numeric values with multipliers and units, to modify the value of the numerical expression. The 
following mnemonics are recognized: 
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Multiplier 


Exp. Note. 


SUEEIX 


Multiplier 


Exp. Note. 


SUEEIX 


EX 


IE 18 


Exa- 


PE 


IE 15 


Peta- 


T 


IE 12 


Tera- 


G 


1E9 


Giga- 


MA 


IE 6 


Mega- 


K 


1E3 


kUo- 


M 


lE-3 


mUli- 


U 


lE-6 


micro- 


N 


lE-9 


nano- 


PI 


lE-12 


pico- 


E 


lE-15 


femto- 


A 


lE-18 


atto- 



STRING DATA 

This data type enables you to transfer a (long) string of characters as a single parameter. Simply enclose any 
seguence of ASCII characters between sin^e or double guotation marks: 

MESSAGE 'Connect probe to point J3' 

The oscilloscope di^lays this message in the Message field above the grid. 

BLOCK DATA 

These are binary data values coded in hexadecimal ASCII : four-bit nibbles translated into the digits 0 through 9 
or A throu^ F, and transmitted as ASCII characters. They are used only for the transfer of waveforms from 
Waverunner to controller (waveform) and for Waverunner panel setups (panel_setup) 

RESPONSE MESSAGES 

The oscilloscope sends a response message to the controller in answer to a gueiy. The format of such messages 
is the same as that of program messages: individual responses in the format of commands, separated by 
semicolons ; and ending in terminators. These messages can be sent back to the oscilloscope in the form in 
which they were received, to be accepted as valid commands. In GPIB response messages, the <NL> <EOI> 
terminator is alw^s used. 

Example: The controller sends the program message: 

TiME_Div?; TRiG_MODE NORM; Cl : COUPLING? (terminator not shown). 

The oscilloscope might respond to this with: 

TiME_Div 50 NS;Ci :COUPLiNG D5 0 (terminator not shown). 

The response message refers only to the gueries: trig_mode is left out. If this re^onse is sent back to the 
oscilloscope, it is a valid program message for setting its timebase to 50 ns/ div and the input coupling of 
Channel 1 to 50 

Whenever you expect a response from the oscilloscope, you must have the control program instruct the G PIB 
or RS-232-C interface to read from the oscilloscope. If fee controller sends another program message without 
reading the response to the previous one, the re^onse message in the output buffer of the oscilloscope will be 
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Chapter One: Ovmiew 



discarded. The oscilloscope keeps to stricter rules for response messages than for acceptance of program 
messages. While you can send program messages from the controller in upper- or lower-case characters, 
response messages are always returned in upper-case. Program messages may contain extraneous spaces or tabs 
(white ^ace), but re^onse messages will not. And while program messages may contain a mixture of short and 
long command or gueiy headers, response messages alw^s use short headers by default. 

However, you can use the command comm_header to force the oscilloscope to use long headers, or none at 
all. If the response header is omitted, the response transfer time will be niinimized. But the response will not be 
able to be sent back to the oscilloscope. Suffix units are also suppressed in the response. 



If you were to set the trigger slope of Channel 1 to negative, the gueiy c i : trs l ? mi^t yield the following 
responses: 



Cl :TRiG_SLOPE NEC header format: long 
Cl: TRS L NEC header format: shoit 

NEC header format: off 



TIP: W^n/efonmyoa (Atain 6om the 
oscilloscope using the query waveform? aw 
a special kind of response nw^age. Control 
their exact format by using the 
COMM_FORMAT and COMM_ORDER 
commands. 



USE ScopeExplorer 

ScopeExplorer is an easy-to-use and practical software tool for interfacing your Waverunner oscilloscope with a 
PC running Windows: 

1. Connect the scope to a PC using either the G PIB (you'll need a PC with G PIB card installed) or PC- 
standard RS-232-C port on the scope's rear panel. 

2. D ownload ScopeExplorer free of charge at http:/ / www.lecroy.com/ scopeexplorer. 0 r inguire at your 
LeCroy customer service center. 

3. Having installed ScopeExplorer, open it as you would any Windows program. Use its on-line help to do the 
following: 



Use the teletype-like terminal to send standard remote control commands from computer to 
oscilloscope, and to displ^ the Waverunner response on the PC. 



Control the scope by means of an interactive, virtual scope front panel. 



Pipe sequences of commands from a file to the scope, then send the scope's responses to another file. 

Transfer pixel-for-pixel copies of your Waverunner display to PC, then view them, print them, or both 
from the computer. With a sin^e press of a button or key, you can copy bitmap waveform images to 
the Windows Clipboard, ready to paste into any Windows application. 

Capture Waverunner front panel setups and, using a long filename, store them on the computer. You 
can then transfer them back into the scope to reproduce an identical setup. 



Transfer your waveforms to PC, and store them in either the compact LeCroy Binary format, or an 
ASCII version compatible with PC-based analysis products. 
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Chapter Two: ContwlbyGPIB 
In this ch^ter, see how 

To address your W^verunner scope forCPIB 

To conBgme GPIB software 

To enable remote or local control 

To make transfers of data 

To make service requests 

To poll Wbverurmer 

To drive Imdcxrpy device 
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Chapter Two 



ConbtibyGPIB 



TalH Listen, orConbol 

You can remotely control your Waverunner oscilloscope, using the G eneral Purpose Interface Bus (G PIB). 

G PIB is similar to a standard computer bus. But while the computer interconnects circuit cards by means of a 
backplane bus, the G PIB interconnects independent devices (oscilloscopes and computers, for example) by 
means of a cable bus. G PIB also carries both program and interface messages. 

Program messages, often called device dependent messages, contain programming instructions, measurement 
results, and oscilloscope status and waveform data 

Interface messages manage the bus itself. They perform functions such as initialization, addressing and 
"unaddressing" of devices, and the setting of remote and local modes. 

TALK LISTEN, OR CONTROL 

On the one hand, devices connected by G PIB to your Waverunner oscilloscope can be listeners, talkers, or 
controllers. A talker sends program messages to one or more listeners, while a controller manages the flow of 
information on the bus by sending interface messages to the devices. The host computer must be able to play 
all three roles. For details of how the controller configures the G PIB for specific functions, refer to the G PIB 
interface manufacturer's manual. 

On the other hand, the Waverunner can be a talker or listener, but not a controller. 

INTERFACE 



Waverunner interface capabilities include the following IEEE 488.1 definitions: 



AHl 


1 Complete Acceptor Handshake 




Complete Device Clear Eunction 


1 SHI 


' Complete Source Handshake 


DTI 


Complete D evice Trigger 


L4 


1 Partial Listener Eunction 


PPl 


Parallel Polling: remote configurable 


T5 


1 Complete Talker Eunction 


CO 


No Controller Eunctions 


SRI 


1 Complete Service Reguest Eunction 


E2 


Tri-state Drivers 


RLl 


' Complete Remote/ Local Eunction 
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Part One: ABOUT REMOTE CONTROL 



ADDRESS 

Every device on the G PIB has an address. To address Wavemnner, set the remote control port to GPIB by 
means of the scope's front panel UTILITIES button and on-screen menus If you select "RS-232" in the same 
way, the oscilloscope will execute over the G PIB solely "talk-only" operations, such as driving a printer. Setting 
Wavemnner to "RS-232" enables the oscilloscope to be controlled through the RS-232-C port. See Chapter 12 
of the Operator's Manual for how to do this. 

If you address Wavemnner to talk, it will remain in that state until it receives a universal untalk command 
(UNT), its own listen address (MLA), or another oscilloscope's talk address 

If you address Wavemnner to listen, it will remain configured to listen until a universal unlisten command 
(UNL), or its own talker address (MTA), is received. 

GPIB SIGNALS 

The G PIB bus system consists of 16 signal lines and ei^t ground or shield lines. The signal lines are divided 
into three groups: 

Data Lines: These ei^t lines, usually called D 101 through D 108, cany both program and interface messages. 
Most of the messages use the 7-bit ASCII code, in which case D 108 is unused. 

Handshake Lines: These three lines control the transfer of message bytes between devices. The process is 
called a three- wire interlocked handshake, and it guarantees that the message bytes on the data lines are sent 
and received without transmission error. 

Interface Management Lines: These five lines manage the flow of information across the interface: 

ATN (ATteNtion): The controller drives the ATN line tme when it uses the data lines to send interface 
messages such as talk and listen addresses or a device clear (D CL) message. When ATN is false, the bus is in 
data mode for the transfer of program messages from talkers to listeners. 

IFC (Interface Clear): The controller sets the lEC line tme to initialize the bus 

RE N (Remote E N able): The controller uses this line to place devices in remote or local program mode. 

SRQ (Service ReQuest): Any device can drive the SRQ line tme to asynchronously request service from the 
controller. This is the equivalent of a single intermpt line on a computer bus. 

EOI (End Or Identify): This line has two purposes: The talker uses it to mark the end of a message string. 
The controller uses it to tell devices to identify their response in a parallel poll (discussed later in this section). 

1/ O BUFFERS 

The oscilloscope has 256-byte input and output buffers. An incoming program message is not decoded before 
a message terminator has been received. However, if the input buffer becomes full (because the program 
message is longer than the buffer), the oscilloscope starts analyzing the message. In this case data transmission 
is temporarily halted, and the controller m^ generate a timeout if the limit was set too low. 
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USE IEEE 48aiSTANDARD MESSAGES 

The IEEE 488.1 standard specifies not only the mechanical and electrical aspects of the G PIB, but also the 
low-level transfer protocol. Eor instance, it defines how a controller addresses devices, turns them into talkers 
or listeners, resets them or puts them in the remote state. Such interface messages are executed with the 
interface management lines of the G PIB, usually with ATN true. 



All these messages except get are executed 
immediately upon receipt. 

The command list in Part Two of this manual does 
not contain a command for clearing the input or 
output buffers, nor for setting the oscilloscope to the 
remote state. 



This is because such commands are already specified as IEEE 488.1 standard messages Refer to the G PIB 
interface manual of the host controller as well as to its support programs, which should contain special calls 
the execution of these messages 

The following description covers those IEEE 488.1 standard messages that go beyond mere reconfiguration of 
the bus and that have an effect on Waverunner operation. 

DEVICE CLEAR 

In response to auniversal Device CLear (DCL) or a Selected Device Clear message (sdc), Waverunner clears 
the input or output buffers, cancels the interpretation of the current command (if any) and clears pending 
commands. However, status registers and status-enable registers are net cleared. Although DCL will have an 
immediate effect, it can take several seconds to execute if the oscilloscope is busy. 

GROUP EXECUTE TRIGGER 

The G roup Execute Trigger message (GET) causes Waverunner to arm the trigger system, and is functionally 
identical to the *trg command. 



NOTE: In addition to the IEEE 48&linteifyce 
message standards, the IEEE 48&2 standard 
spedOes certain standardized program rrwssages, 
i.e., command hewers. TheyareidentiSedwitha 
le^ling asterisk* and are listed in the System 
Commands section. \ 



REMOTE ENABLE 

This interface message is executed when the controller holds the Remote ENable control line (REN) true, 
allowing you to configure the oscilloscope as a listener. All the front panel controls except the menu buttons 
are disabled. The menu indications on the ri^t-hand side of the screen no longer appear, since menus cannot 
now be operated manually. Instead, the text REMOTE ENABLE appears at the top of the menu field to 
indicate that the oscilloscope is set in the remote mode. Whenever die controller returns the REN line to false, 
all oscilloscopes on the bus return to G 0 TO LO CAL. 

When you press the G 0 TO LO CAL menu button, the scope returns to front panel control, unless you have 
placed the oscilloscope in Local LOckout (LLO) mode (see below). 
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The G 0 To Local message (GTL) causes the oscilloscope to return to local mode. All front panel controls 
become active and the normal menus reappear. Thereafter, whenever the oscilloscope is addressed as a listener 
it will be immediately reset to the remote state, except when the LLO command has been sent. 

When you activate Local Lockout the scope can only be returned to its local state by returning the LLO to 
false. Whenever you return the oscilloscope to the remote state the local lockout mode will immediately 
become effective again. 

The Local LO ckout message (LLO ) causes the G 0 TO LO CAL menu to disappear. You can send this message 
in local or remote mode. But it only becomes effective once you have set the oscilloscope in remote mode. 

INTERFACE CLEAR 

The InterFace Clear message (IFC) initializes the G PIB but has no effect on the operation of the Waveruriner. 



NOTE: To illustrate the GPIB progianmiing concepts a number of exanqrles written in BASICA are 
included here. It is assumed that the controller is IBM-PC corrgjatibie, rurming under DOS, and that 
it is equipped with a National Instruments GPIBinterfyce card. Nevertheless, GPIB programming 
with otherianguages such as C orl^scalis quite similar. If you're using another type of computer or 
GPIB interface, refer to the interfyce manual for installation procedures and submutine calls. \~z 



CONFIGURE THE GPIB DRIVER SOFTWARE - 

1. Verify that the G PIB interface is properly installed in the computer. If it is not, follow the interface 
manufacturer's installation instructions. In the case of the National Instruments interface, it is possible to 
modify the base 1/ 0 address of the board, the D MA channel number, and the interrupt line setting using 
switches and jumpers. In the program examples below, default positions are assumed. 

2. Connect Waveruriner to the computer with a G PI B interface cable. 

3. Set the G PIB address to the recpred value. The program examples assume a setting of 4 

The host computer recjuires an interface driver that handles the transactions between the operator's programs 
and the interface board. 

In the case of the National Instruments interface, the installation procedure wUl: 
a Copy the G PIB handler G PIB.CO M into the boot directory. 

b. Modify the D 0 S system configuration file CO NFIG .SY S to declare the presence of the G PIB handler. 

c. Create a sub-directory called G PIB-PC, and install in G PIB-PC a number of files and progiums useful for 
testing and reconfiguring the system, and for writing user progiums. 

The following files in the sub-directory G PIB-PC are particularly useful: 

IBIC.EXE allows interactive control of the G PIB by means of functions entered at the keyboard. Use of this 
program is hi^ly recommended to anyone unfamiliar with G PIB progiumming or with Wavemriner's remote 
commands. 
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DECL.BAS is a declaration file that contains code to be included at the beginning of any BASICA application 
program. Simple application programs can be quickly written by appending the operator's instructions to 
DECL.BAS and executing the complete file. 

IBCONF.EXE is an interactive program that allows inspection or modification of the current settings of the 
G PIB handler. To run IBCO NF.EXE, refer to the National Instruments manual. 




MAKE SIMPLE TRANSFERS 



For a large number of remote control operations it is sufficient to use just three different subroutines 
(IBFIND, IBRD and IBWRT) provided by National Instruments. The following complete program reads the 
timebase setting of Waverunner and displ^s it on the terminal: 



1-99 


<DECL 


,BAS> 


100 


DEV$ = 


"DEV4" 


no 


CALL 


IBFIND (DEV$, SCOPE% 


120 


CMD$ = 


"TDIV?" 


130 


CALL 


IBWRT (SCOPE%, CMDS) 


140 


CALL 


IBRD (SCOPE%, RD$) 


150 


PRINT 


RD$ 


160 


END 





Lines 1-99 are a copy of the file DECL.BAS supplied by National Instruments The first six lines are required 
for the initialization of the G PIB handler. The other lines are declarations which may be useful for larger 
programs but are not really required code. The sample program above only uses the strings cmd $ and rd $ , 
which are declared in DECL.BAS as arrays of 255 characters. 

Lines 100 and 110 open the device dev4 and associate with it the descriptor scope%. All 1/ 0 calls after that 
wOreferto scope%. The default configuration of the G PIB handler recognizes dev4 and associates with it a 
device with the G PIB address 4. 

Lines 120 and 130 prepare the command string td i v? and transfer it to the oscilloscope. The command 
instructs the oscilloscope to respond with the current setting of the timebase. 
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Lines 140 and 150 read the response of the oscilloscope and place it into the character string rd $ . 

Line 170 displays the response on the terminal. 

NOTE: DECL.BAS requires access to the file BIB.M during the GPIB initialization. BIB.M 
is one of the files supplied by National Instruments, and it must exist in the directory 
currently in use. 

The first two lines of DECL.BAS both contain a stringXXXXX, which must be replaced by the number of 
bytes that determine the maximum workspace for BASICA (computed by subtracting the size of BIB.M from 
the space currently available in BASICA). Eor example, if the size of BIB.M is 1200 bytes, and when BASICA 
is loaded it reports "60200 bytes free," you should replace "XXXXX " by the value 59 000 or less. 

When running this sample program, Waverunner will automatically be set to the remote state when IBWRT is 
executed, and will remain in that state. Pressing the LO CAL menu button will return Waverunner to local mode 
if the G PIB handler was modified to inhibit Local LO ckout (LLO ). Here is a sh^tly modified version of the 
sample program that checks if any error occurred during G PIB operation: 

1-99 <DECL.BAS> 

100 DEV$="DEV4" 

110 CALL IBFIND (DEV$, SCOPE%) 

120 CMD$="TDIV?" 

130 CALL IBWRT (SCOPE%, CMOS) 

140 IF ISTA% < 0 THEN GOTO 200 

150 CALL IBRD (SCOPE%, RD$) 

160 IF ISTA% < 0 THEN GOTO 250 

170 PRINT RD$ 

180 IBLOC (SCOPE%) 

190 END 

200 PRINT "WRITE ERROR =";IBERR% 

210 END 

250 PRINT "READ ERROR =";IBERR% 

260 END 

TheGPIB status word iSTA%,theGPIB error variable iberr% and the count variable ibcnt% are defined 
by the G PIB handler and are updated with every G PIB function call. Refer to the National Instruments manual 
for details. The sample program above would report if the G PIB address of the oscilloscope was set to a value 
other then 4. Line 180 resets the oscilloscope to local with a call to the G PIB routine IBLO C. 
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USE ADDITIONAL DRIVER CALLS 

IBLOC is used to execute the IEEE 488.1 standard message G o To Local (GTL), i.e. it returns the 
oscilloscope to the local state. The prograrnming example above illustrates its use. 

IBCLR executes the IEEE 488.1 standard message Selected Device Clear (SDC). 

IBRDF and IBWRTF, re^ectively, allow data to be read from G PIB to a file, and written from a file to 
G PIB. Transferring data dii^tly to or from a storage device does not limit the size of the data block, but 
may be slower than transferring to the computer memory 

IBRDI and IBWRTI allow data to be read from G PIB to an integer art^, and written from integer art^ 
to G PIB. Since the integer art^ allows storage of up to 64 kilobytes (in BASIC), IBRD I and IBWRTI 
should be used for the transfer of large data blocks to the computer memory rather than IBRD or 
IBWRT, which are limited to 256 bytes by the BASIC string length. N ote that IBRD I and IBWRTI only 
exist for BASIC, since for more modem programming languages, such as C, the functions called IBRD 
and IBWRT are far less limited in data block size. 

IBTMO can be used to change the timeout value during program execution. The default value of the 
G PIB driver is 10 seconds — for example, if the oscilloscope does not respond to an IBRD call, IBRD 
will return with an error after the specified time. 

IBTRG executes the IEEE 488.1 standard message Group Execute Trigger (G ET), which causes 
Waverunner to arm the trigger system. 

National Instruments supply a number of additional fimction calls. In particular, it is possible to use the so- 
called board level calls, which allow a very detailed control of the G PIB. 



NOTE: The SRQ bit is latched until the contmiler reads the STatus Byte Register (STB). The action 
of reading the STB with the command *stb? cleats the register contents except the MAV hit (hit 4) 
until a new e\^t occurs. Service requesting can he disabled by clearing the SRE register 
with the *SRE 0 command. — 



MAKE SERVICE REQUESTS 

When a Waverunner is used in a remote application, events often occur asynchronously, i.e., at times that are 
unpredictable for the host computer. The most common example of this is a trigger wait after the oscilloscope 
is armed: the controller must wait until the acguMtion is finished before it can read the acgurred waveform. 

The simplest way of checking if a certain event has occurred is by either continuously or periodically reading 
the status bit associated with it until the required transition is detected. Continuous status bit polling is 
described in more detail below. For a complete explanation of status bits refer to Chapter 5. 

Perhaps a more efficient way of detecting events occurring in the oscilloscope is the use of the Service Request 
(SRQ ). This G PIB interrupt line can be used to interrupt program execution in the controller. The controller 
can then execute other programs while waiting for the oscilloscope. Unfortunately, not all interface 
manirfacturers support the programming of interrupt service routines. In particular. National Instruments 
supports only the SRQ bit within the ISTA% status word. This recpres you to continuously or periodically 
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check this word, either explicitly or with the function call IBWAIT. In the absence of real interrupt service 
routines the use of SRQ not be very advantageous. 

In the default state, after power-on, the Service ReQuest is disabled. You enable SRQ by setting the Service 
Reguest Enable register with the command "*SRE " and by specifying which event should generate an SRQ. 
Waverunner will interrupt the controller as soon as the selected event(s) occur by asserting the SRQ interface 
line. If several devices are connected to the G PIB, you m^ be reguired to identify which oscilloscope caused 
the interrupt by serial polling the various devices. 

Exanqile: To assert SRQ in re^onse to the events "new signal acguired" or "retum-to-local" (pressing the 
soft key/ menu button for G Q TQ LQ CAL).These events are tracked by the INR register, which is reflected in 
the SRE register as the INB summary bit in position 0. Since bit position 0 has the value 1, the command 
* SRE 1 enables the generation of SRQ whenever the INB summary bit is set. 

In addition, the events of the INR register that m^ be summarized in the INB bit must be specified. The 
event "new signal acguired" corresponds to INE bit 0 (value 1) while the event "retum-to-local" is assigned to 
INE bit 2 (value 4). The total sum is 1 -I- 4 = 5. Thus the command ine 5 is needed: 

CMD$="INE 5;*SRE 1" 

CALL IBWRT (SCOPE%, CMD$) 

Exanqile: To assert SRQ when soft key 4 (fourth menu button from top of screen) is pressed. The event "soft 
key 4 pressed" is tracked by the URR register. Since the URR register is not directly reflected in STB but only in 
the E SR register (URR, bit position 6), the E SE enable register must be set first with the command * E s E 64 
to allow the URQ setting to be reported in STB. An SRQ request will now be generated provided that the E SB 
summary bit (bit position 5) in the SRE enable register is set (* SRE 32): 

CMD$="*ESE 64;*SRE 32" 

CALL IBWRT (SCOPE%, CMD$) 



NOTE; The tenn "soft-key, " used hew in wfewnce to wmote operations, is synonymous with "menu 
hutton," used in the accon^tanyinff Operator's Manual to mean hunt panei operations. Both terms 
wferto the column of seven hutbons rurming parallel to the screen on the Uhverurmer hunt panel and 
the menu functions they control. 



y 
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Take Insbimieiit Polls 



You can regularly monitor state transitions within the oscilloscope by polling selected internal status registers. 
There are four basic polling methods you can use to detect the occurrence of a given event: continuous, serial, 
parallel, and * i s t . By far the simplest of these is continuous polling. The others are appropriate only when 
interrupt-service routines (servicing the SRQ line) are supported, or multiple devices on G PIB require constant 
monitoring To emphasize the differences between the methods, described below, the same example 
(determining whether a new acquisition has taken place) is used in each case. 

DO CONTINUOUS POLLING 

A status register is continuously monitored until a transition is observed. This is the most straightforward 
method for detecting state changes, but m^ not be practical in certain situations, e^ecially with multiple 
device configurations 

In the following example, the event "new signal acquired" is observed by continuously polling the INtemal 
state change Register (INR) until the corre^onding bit (in this case bit 0, i.e., value 1) is non-zero, indicating a 
new waveform has been acquired. Reading INR clears this at the same time, so that there is no need for an 
additional clearing action after a non-zero value has been detected. The command chdr off instructs the 
oscilloscope to omit any command headers when responding to a query, simplifying the decoding of the 
response. The oscilloscope will then send "1" instead of "INR 1": 

CMD$="CHDR OFF" 

CALL IBWRT (SCOPE%, CMD$) 

MASK% = 1 'New Signal Bit has value 1' 

LOOP% = 1 
WHILE LOOP% 

CMD$="INR?" 

CALL IBWRT (SCOPE%, CMD$) 

CALL IBRD (SCOPE%, RD$) 

NEWSIG% = VAL(RD$) AND MASK% 

IF NEWSIG% = MASK% THEN LOOP% = 0 
WEND 



TAKE A SERIAL POLL 

Serial polling takes place once the SRQ interrupt line has been asserted, and is only advantageous when you are 
using several oscilloscopes at once. The controller finds which oscilloscope has generated the interrupt by 
inspecting the SRQ bit in the STB register of each. Because the service request is based on an interrupt 
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mechanism, serial poUing offers a reasonable compromise in terms of servicing speed in multiple-device 
configurations. 

In the following example, the command ine i enables the event "new signal acguired" to be reported in the 
INR to the INB bit of the status byte STB. The command * sre i enables the INB of the status byte to 
generate an SRQ whenever it is set. The function call IBWAIT instructs the computer to wait until one of 
three conditions occurs: &H8000 in the mask (MASK%) corre^onds to a G PIB error, &H4000 to a timeout 
error, and &H0800 to the detection of RQ S (ReQuest for Service) generated by the SRQ bit. 

Whenever IBWAIT detects RQ S it automatically performs a serial poll to find out which oscilloscope generated 
the interrupt. It will only exit if there was a timeout or if the oscilloscope (scope%) generated SRQ. The 
additional function call ibrsp fetches the value of the status byte, which may be further interpreted. Forthis 
to work properly the value of "Disable Auto Serial Polling" must be set to "off" in the GPIB handler (use 
IBCONF . EXE to check): 

CMD$="*CLS; INE 1; *SRE 1" 

CALL IBWRT (SCOPE%, CMD$) 

MASK% = &HC800 

CALL IBWAIT (SCOPE%,MASK%) 

IF (IBSTA% AND &HC000) <> 0 THEN PRINT "GPIB or Timeout Error" : STOP 

CALL IBRSP (SCOPE%, SPR%) 

PRINT "Status Byte SPR% 

Board-level function calls can deal simultaneously with several oscilloscopes attached to the same interface 
board. Refer to the National Instruments manual. 



NOTE: Alter the serial poll is conqjleted, the RQS bit in the STB status register is cleared Note that 
the other STB register bits remain set until they are cleared by rtwans of a "*CLS" conrmand or the 
oscilloscope is reset If these bits are not cleared, they cannot generate anoiherintemgjt FI 



DO A PARALLEL POLL 






Like serial polling, this is only useful vrith several oscilloscopes. The controller simultaneously reads the 
Individual STatus bit (1ST) of all oscilloscopes to determine which one needs service. This method allows up 
to eight different oscilloscopes to be polled at the same time. 

When a parallel poll is initiated, each oscilloscope returns a status bit over one of the D IQ data lines. D evices 
may respond either individually, using a separate D IQ line, or collectively on a single data line. D ata-line 
assignments are made by the controller using a Parallel Poll Configure (PPG) sequence. 

In the following example, the command ine i enables the event "new signal acquired" in the INR to be 
reported to the INB bit of the status byte STB. The PaRallel poll Enable register (PRE) determines which 
events will be summarized in the 1ST status bit. The command *pre i enables the INB bit to set the 1ST bit 
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whenever it is itself set. 0 nee parnllel polling has been established, the painllel-poll status is examined until a 
change on data bus line D 102 takes place. 

Stage 1 

1. Enable the INE and PRE registers 

2. Configure the controller for parallel poll 

3. Instruct Waverunner to respond on data line 2 (D 102) with these commands: 

CMD1$="?_0$" 

CALL IBCMD (BRD0%, CMD1$) 

CMD$="INE 1;*PRE 1" 

CALL IBWRT (BRD0%, CMD$) 

CMD4$=CHR$ (&H5) +CHR$ (&H69) +"?" 

CALL IBCMD (BRD0%, CMD4$) 

Stage 2 

4. Parallel poll the oscilloscope until D 102 is set with these commands: 

LOOP% = 1 
WHILE LOOP% 

CALL IBRPP (BRD0%, PPR%) 

IF (PPR% AND &H2) = 2 THEN LOOP% = 0 
WEND 

stages 

5. D isable parallel polling (hex 15) and clear the parallel poll register with these commands: 

CMD5$=CHRS (&H15) 

CALL IBCMD (BRD0%, CMD5$) 

CALL IBCMD (BRD0%, CMD1$) 

CMD$="*PRE 0"CALL IBWRT (BRDO %, CMD$ ) : 

In the above example, board-level G PIB function calls are used. It is assumed that the controller (board) and 
Waverunner (device) are re^ectively located at addresses 0 and 4. 
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The listener and talker addresses for the controller and Waverunner are: 



Logic Device 


Listener Address 


Talker Address 


External Controller 


32 ASCII <space>) 


64 (ASCII©) 


Waverunner 


32+4=36 (ASCII $) 


64+4=68 (ASCII D) 1 



PERFORM AN *IST POLL 

You can also read the state of the Individual STatus bit (1ST) returned in paruUel polling by sending the 
* I s T ? guery. To enable this poll mode, you must intialize Waverunner as for parklel polling by writing into 
the PRE register. Since * i s T emulates parallel polling, apply this method wherever parallel polling is not 
supported by the controller. In the following example, the command ine i enables the event "new signal 
acguired" in the INR to be reported to the INB bit of the status byte STB. The command *pre i enables 
the INB bit to set the 1ST bit whenever it is set. The command chdr off suppresses the command header 
in the oscilloscope's response, simplifying the interpretation. The status of the 1ST bit is then continuously 
monitored until set by tire oscilloscope: 

CMD$="CHDR OFF; INE 1; *PRE 1" 

CALL IBWRT (SCOPE%, CMD$) 

LOOP% = 1 
WHILE LOOP% 

CMD$="*IST?" 

CALL IBWRT (SCOPE%, CMD$) 

CALL IBRD (SCOPE%, RD$) 

IF VAL(RD$) = 1 THEN LOOP% = 0 
WEND 



NOTE: The chaiact^ "?" and " spearing in the command strings stand for uniisten and untalk 
lespectivety. Th^ are med to set the devices to a "known" state. To shortm the size of the program 
examples, device talking and listening initiaiization instructions have heen gmigmiinto character 
chains. They are: CViDl$ = "?_0$" Unlisten, Untalk, pc talker, DSO listener. 
The remote message code for executing a parallel response in hinaryform is OUOIPPE wheie PPP 
speciffes the data line. Because data line 2 is selected, theidmUBcationcodeisOOl, nhich results in 
the code 01101001 (hinary) or &H& (hex). See Table 38 of the IEEE 488- 19^ Standard 
for further details. 
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Drive Haid-o^ Devices on the GPIB 

You can interface your Wavemnner oscilloscope with a wide range of hard-copy devices, such as printers and 
plotters, and copy the screen contents to them. List the devices supported using the command 

HARDCOPY_SETUP. 

With a hard-copy device connected to the G PIB, you can use either of two basic configurations. When only 
Wavemnner and a hardcopy device such as a printer are connected, you must configure the oscilloscope as 
talker-only and the hardcopy device as listener-only, to ensure proper data transfer. However, when an external 
controller is connected to the G PIB, you must use this controller to supervise the data transfers. You can then 
use a variety of schemes to transfer Wavemnner screen contents. 

Configure Wavemnner as talker-only with its front panel controls. The hardcopy device manufacturer usually 
specifies an address that forces the oscilloscope into listening mode, and you can select this as well as the other 
necessary settings using the same menus. SeeChapterd, "Document Your Work" of the Opaatrr's 
Manual . 

Use the following schemes for driving hard copy devices by remote control using G PIB. 



READ DATA BY CONTROLLER 

The controller reads the data into internal memory, then sends them to the printer. You can arrange this with 
simple hi^-level G PIB fimction calls. The controller stores the full set of printer instmctions and afterwards 
sends them to the graphics device. This method is the most strai^tforward w^ to transfer screen contents, 
but reguires a large amount of buffer storage: 

CMD$ = "SCDP" 

CALL IBWRT (SCOPE%, CMD$) 

FILE$="PRINT.DAT" 

CALL IBRDF (SCOPE%, FILE$) 

CALL IBWRTF (PRINTER%, FILE$) 

SEND DATA TO BOTH 

Wavemnner sends data to both controller and printer. The oscilloscope puts the printer instmctions onto the 
bus. The data is directly put out and saved in scratch memory in the controller. The contents of the scratch file 
can be deleted later: 

Stage 1 Controller talker, Wavemnner listener. 

1. Issue the screen dump command 

CMD1$="? 0$"; CALL IBCMD (BRDO % , CMDl $ ) 

CMD$="SCDP": CALL IBWRT (BRDO %, CMD$ ) 
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Stage 2: Wavemnner talker, controller and printer listeners. 

2. Print data while storing data in scratch file SCRATCH .DAT with the commands 

CMD2$="? D%": CALL IBCMD (BRD0%, CMD2$ ) 

FILE$="SCRATCH.DAT": CALL IBRDF (BRD0%, FILE$) 

TALKDIRECTLYTO PRINTER 

a The controller goes into a standby state. 

b. Waverunner becomes a talker and sends data directly to the printer. 

c. The controller goes into standby and resumes G PIB operations once the data have been printed, i.e., when 
anEOI is detected: 

Stage 1 Controller talker, Waverunner listener. 

1. Issue the screen dump command 

CMD1$="?_0$" : CALL IBCMD (BRDO %, CMDl $ ) 

CMD$="SCDP": CALL IBWRT (BRDO % , CMD$ ) 

Stage 2: Waverunner talker, printer or plotter listener. 

2. Put controller in standby: 

CMD2$="?_D%" ; CALL IBCMD (BRDO %, CMD2 $ ) 

V%=1: CALL IBGTS (BRD0%, V%) 

In the second and third schemes presented above, board-level G PIB function calls are used. It is assumed that 
the controller (board), Waverunner and the printer are re^ectively located at addresses 0, 4, and 5. 

The listener and talker addresses for the controller, Waverunner, and printer are as follows: 



Logic Device 


Listener Address 


Talker Address 


Controller 

1 


32 (ASCII <^ace>) 
1 


64 (ASCII©) 


Waverunner 


32-i4=36 (ASCII $) 


64-i4=68 (ASCII D) 


Printer 


32-i5=37 (ASCII %) 


64-i5=69 (ASCII E) 



The characters " 7 ‘ and appearing in the command strings stand for unlisten and untalk respectively. They 
are used to set the devices to a "known" state. 
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To shorten the size of the program examples, device talking and listening initialization instructions have been 
grouped into character chains. They are: 

CMD 1 $ = " ?_0 $ " Unlisten, Untalk, Controller talker, Waverunner listener 



CMD2S = "?_ D" 



Unlisten, Untalk, Controller listener, Waverunner talker 

C9 
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Chapter Three: ContzolbyRS232 
In this ch^ter, see how 

To control WaMmmnerby RS-232-C 
To simulate GPIB messages using RS-232-C 
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Conmiumcate thiou^ the RS-232-C Poit 

Your Wavemnner oscilloscope can also be controlled remotely through the RS-232-C port, which supports the 
transfer of all commands for its operation. Nevertheless, RS-232 waveform transfer is only possible in HEX 
mode, using the default value for comm_format, and with the syntax of the response to WF? identical to 
that for G PI B. 

RS-232-C connector pin assignments for connecting Waverunner to an external controller are given in Chapter 
12, "Use Waverunner with PC" of the Waverunner Operator's Manual. 

The RS-232-C port is full-duplex configured. This means that both sides — Waverunner oscilloscope and 
external controller — can send and receive messages at the same time. However, the oscilloscope stops 
outputting when it receives a new command. 

You should transmit long messages to the oscilloscope while it is in a trigger mode, and not while an 
acguisition is in progress. This is especially important when sending waveforms or front panel setups. 

Characters that cannot be printed in ASCII are here represented by their mnemonics. For example: 

<LF > A SCI I line feed character whose decimal value is 10. 

<B S> A SCI I backspace character whose decimal value is 8. 

CTRL_u The control key and the U key are pressed simultaneously. 

Set RS-232-C behavior according to your needs. In addition to the basic setup on the front panel menu, there 
are "immediate commands," as well as the special command comm_rs 2 3 2 for this. Immediate commands 
consist of the ASCII ESCape character <ESC> (whose decimal value is 27), followed by another character. 
These commands are interpreted as soon as the second character has been received. 

You can have the serial port echo the received characters. This is useful when the oscilloscope is connected to a 
terminal. Echoing can be turned on or off by sending the two-character seguence <ESC>] or <ESC>[. 
Echoing is on by default, but the host must not echo characters received from the oscilloscope. 

HANDSHAKE CONTROL 

When the oscilloscope intake buffer becomes nearly full, the instrument sends a handshake signal to the host 
telling it to stop transmitting. When this buffer has enough room to receive more characters, another 
handshake signal is sent. These signals are either the ctrl-s (or <XOFF>) and ctrl-q (<X0N>) 
characters, or a signal level on the RTS line. They are selected by sending the two-character seguence <E SC>) 
for XO N/ XO FF handshake (the default), or <E SC > for the RTS handshake. 

You can control the flow of characters coming from the oscilloscope by either a signal level on the CTS line or 
the <XON>/ <XOFF> pair of characters. 
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NOTE; The RS-232-C baud mte, parity, character length, and number of stop bits are among the 
parameters saved or recalled by the bunt panel SAVE or RECALL buttons, and by the remote 
cormnands*SAV, *rcl, orPANEL_SETUP. When recallir^ by remote, ensure that these parameters 
are set at the same value on both controller and oscilloscope. Otherwise, the host may no longer be^ 
able to corranunicate with the oscilloscope and a manual reconSguration would be necessary. 



EDITING FEATURES 

When the oscilloscope is directly connected to a terminal, the following will make correction of typing errors 
easier: 

<BS> or <DELETE> Delete the last character. 

CTRL_u Delete the last line. 



MESSAGE TERMINATORS 

Message terminators are markers that indicate to the receiver that a message has been completed. The Program 
Message Terminator is a character you could select when you input to the oscilloscope. Choose a character 
never used for anything else, using the command comm_rs2 3 2 and the keyword El. The default Program 
Message Terminator is the ASCII character <CR>, whose decimal value is 13. 

The oscilloscope appends a Re^onse Message Terminator to the end of each of its responses. This is a string, 
similar to a computer prompt, which you also choose. This string must not be empty. The default Re^onse 
Message Terminator is \ n \ r , which is the same as <LPxCR>. 

Exanqile: comm_rs2 32 ei,3 

This command informs the oscilloscope that each message it receives will be terminated with the ASCII 
character <ETX >, whose decimal value is 3. 

Exanqile: C0MM_RS232 EO, "\r\nEND\r\n" 

This command indicates to the oscilloscope that it must append the string "\ A nEND\ A n" to each response. 
After you make these settings, a host command will look like this: 

TDIV?<ETX> 

And the oscilloscope will respond with: 

TDIV l.S 
END 
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TIP: Alter it sends a COMM_ RS232 conmiand, the host must wait for the oscilloscope to change its 
behavior before it can send a conmiand in the new mode. Ensure this by including a query on the line 
that contains the C0MM_RS2 32 command (for example, comm_rs232 ei, 3; *stb?) and waiting 
until the response is received. 



SRQ MESSAGE 

Each time the Master Summaiy Status (MSS) bit of the STatus Byte (STB) is set, the SRQ message (a string of 
characters) is sent to the host to indicate that the oscilloscope recpiests service. The RS-232-C SRQ message 
has the same meaning as the G PIB SRQ message. If the string is empty no message will be sent. This is the 
default setting. N ote that no response message terminator is added at the end of the SRQ message. 

Example: C0MM_RS232 SRQ, "\r\n\nSRQ\r\n\a" 

When the MSS bit is set, the oscilloscope will send a <CR> followed by two <LE>SRQ, and a <CR> followed 
by a <LE>. The buzzer will sound. 

LONG LINE SPLITTING 

Line splitting is a feature provided for hosts that cannot accept lines with more than a certain number of 
characters The oscilloscope may be configured to split responses into many lines This feature is very useful for 
waveform or front panel setup transfers althou^ it is applicable to all re^onse messages Two parameters 
control this feature: 

Line Separator: Qff 

- messages will not be split into lines 

<CR>,<LE> or <CRxLE> 

- possible line terminators 

Line Length:the maximum number of characters to a line. 

Example: comm_rs232 ls,lf,ll,40 

The line separator is the ASCII character <LE>, the line is a maximum of 40 characters long (excluding the 
line separator). 

If the oscilloscope receives the command PNSU?, it may answer with: 

PNSU#9000001496 

AAAA5555000655AA40300058001 9000000000001 
000000000000000000000000000C1B0100580000 
0000000000000000000000000000000000000000 
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REMARKS 

Long commands sent to the oscilloscope may not be split into lines. If a command sent to the oscilloscope is 
the response to a previous query, the line-split characters (<LF>, <CR>) must be removed. This also applies to 
line-split characters inside strings sent to the oscilloscope. 

However, hex-ASCII data sent to the oscilloscope may contain line-split characters. If you wish to use line 
splitting, ensure that neither the input message terminator characters nor the line-split characters occur in the 
data 
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Sumdate GPIB Messages 

Use these RS-232-C commands to simulate GPIB 488.1 messages: 



RS232 Command 


GPIB Message 


Eeeect and Equivalence 


<ESC>C or <ESC>c 


Device Clear (DCL) 


Clears the input and output buffers. This command 
has the same meaning as the G PIB D CL or SD C 
interface messages. 


<ESC>R or <ESC>r 


Remote Enable (REN) 


Places the oscilloscope in remote mode. This 
command's function is the same as the G PIB 
command asserting the REN line and setting the 
oscilloscope to listener. 


<ESC>L or <ESC>1 


Go to Local (GTL) 


Places the oscilloscope in local mode. The command 
clears local lockout (see below). It has the same 
function as G PIB's setting the REN line to false. 


<ESC>E or<ESC>f 


Local Lockout (LLO) 


Disables the front panel "LO CAL" button 
immediately if the oscilloscope is already in remote 
mode or, if not, when the oscilloscope is next set to 
remote. This Local Lockout (see Chapter 2, "Control 
by G P I B " ) can be cancelled only with the <E SC >L 
command. <ESC>PhasthesamemeaningasGPIB's 
LLO interface message. 


<ESC>T or<ESC>t 


G roup Execute Trigger 
(GET) 


Re-arms the oscilloscope while it is in the STO P mode, 
but only while the oscilloscope is in remote mode. This 
command has the same meaning as the * trg 
command and G PIB's G ET interface message. 
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Chapter Four: Undeisiand and Manage Waveforms 
In this ch^ter, see how 

To learn how waveforms aw structmed 
To inspect waveform contents 
To bansfer waveforms rapidly 
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Chapter Four 



Und&stand and Manage Wavefonns 



Know Your WfeR/efomi 

A waveform can be said to have two main parts. The first is its basic data array: raw data values from the 
oscilloscope's ADCs (Analog- to-Digital Converters) obtained in the waveform's capture. The second is the 
description that accompanies this raw data: the vertical and horizontal scale or time of day, for example, 
necessary for a full understanding of the information contained in the waveform. 

Y ou can access this information by remote control using the inspect? query (see page 36), which interprets 
it in an easily imderstood ASCII text form. And you can rapidly transfer the information using the 
WAVEFORM? query (see page 37). Or write it back into the os^oscope with the waveform command (page 
42). 

Your Waverunner oscilloscope contains a data structure, or template (see Appendix II), which provides a 
detailed description of how waveform information is organized. Although a sample template is provided with 
this manual, we suggest you use the temp late ? query to access the Waverunner template in the oscilloscope 
itself (the template may change as your oscilloscope's firmware is enhanced). 

You can also store waveforms in preformatted ASCII output, for popular spreadsheet and math processing 
packages, using the STORE and STORE SETUP commands. Also see Chapter 12, "Use Waverunner 
with PC," of the Opaatrr's Manual. 

LOGICAL DATA BLOCKS 

Each of your waveforms will normally contain at least a waveform descriptor and data array block. However, 
other blocks m^ also be present in more complex waveforms. 

Wbivefoim Descriptor block (WAVE DE SC): This includes all the information necessary to reconstitute the 
display of the waveform from the data, including: hardware settings at the time of acquisition, the exact time of 
the event, kinds of processing performed, your oscilloscope name and serial number, the encoding format used 
for the data blocks, and miscellaneous constants 

Optional User-provided Text block (USERTEXT): Use the wftx command to put a title or description of 
a waveform into this block, and the wf t x ? query for an alternative w^ to read it. This text block can hold up 
to 160 characters. Di^lay them as four lines of 40 characters by selecting "Text & Times" from the status 
menu, using Waverunner front panel controls (see the Opaatcr's Manual). 

Sequence Acquisition Times block (TRIGTIME): This is needed for sequence acquisitions to record the 
exact timing information for each segment. It contains the time of each trigger relative to the trigger of the 
first segment, as well as the time of the first data point of each segment relative to its trigger. 

Random interleaved sanqrling times block (RISTIME): This is required for RIS acquisitions to record the 
exact timing information for each segment. 
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First data array block (SIMPLE or DATA_ ARRAY_ 1): This is the basic integer data of the waveform. It 
can be raw or corrected ADC data or the integer result of waveform processing 

Second data array block (DATA_ARRAY_2): This is a second data array, needed to hold the results of 
processing functions such as Extrema or EFT math functions: 





Extrema 


EFT 


DATAARRAYl 


Roof trace 


Real part 


DATA_ARRAY_2 


Floor trace 


Imaginary part 



INSPECT WAVEFORM CONTENTS 



NOTE: The Uhvenuinerten^Jate 
also describes an aiia^ named DUAL. 
But this is simply a way to allow the 
INSPECT? command to examine the 
two data arrays together. , 







Use the inspect ? gueiy to examine the contents of your waveform. You can use it on both of the main 
waveform parts Its most basic form is: inspect? "name", the template giving you the name of a 
descriptor item or data block. The answer is returned as a sin^e string, but m^ cover many hnes Some typical 
dialogue follows: 

Question ci: inspect? "vertical_offset" 

Response CI:INSP "VERTICAL_0FFSET : I.5625e-03" 

Question ci: inspect? "trigger_time" 

Response CI:INSP "TRIGGER_TIME: Date = FEB 17, 1994, Time = 4: 4:29.5580" 

You can also use INSPECT? to provide a readable translation of the full waveform descriptor block using 
INSPECT? "WAVEDESC". Again, the template win give you the details for interpretation of each of the 
parameters. Use, too, INSPECT? "simple" to examine the measured data values of a waveform. For an 
acguisition with 52 points, for example: 



INSPECT ? "SIMPLE 




















Cl : 

0 


INSP " 
.0005225 


0 . 


0006475 


-0 


0 0 0 2 9 


-0 . 


000915 


2 


25001 E -0 


0 


000835 


0 


.0001475 


-0 . 


0013525 


-0 


0 02 0 4 


- 4 E 


-05 


0 


0011475 


0 


0011475 


-0 


. 000915 


-0 . 


00179 


-0 


0002275 


0 . 


0011475 


0 


001085 


-0 


0 0 0 7 9 


-0 


.00179 


-0 . 


0002275 


0 


0 0 0 7 1 


0 . 


0 0 0 9 6 


-0 


0003525 


-0 


00104 


0 


.0002725 


0 . 


0007725 


0 


0 0 0 7 1 


-0 . 


0003525 


-0 


00129 


-0 


0002275 


0 


.0005225 


0 . 


0 0 0 4 6 


-0 


00104 


-0 . 


00154 


0 


0005225 


0 


0012725 


0 


.001335 


-0 . 


0009775 


-0 


001915 


-0 . 


000165 


0 


0012725 


0 


0 0 0 9 6 


-0 


. 000665 


-0 . 


001665 


-0 


0001025 


0 . 


0010225 


0 


0 0 0 9 6 


-0 


0003525 


-0 


. 000915 


8 . 


50001 E -0 


0 


000835 


0 . 


0005225 
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The numbers in the table above are the fully converted measurements in volts. When the data block contains 
thousands of items the string will contain a great many lines. 

D epending on the application, you m^ prefer the data in its raw form, with either a BYTE (8 bits) or a 
WORD (16 bits) for each data value. In that case, use the relations INSPECT? "simple", byte with 
WAVEFORM? . The examination of data values for waveforms with two data art^s can be performed as 
follows: 

INSPECT? "DUAL" to get pairs of data values on a single line 

INSPECT ? "DATA_ARRAY_i " to get the values of the first data array 

INSPECT? "DATA_ARRAY_2" to get the values of the second data array. 

INSPECT? has its limitations; it is useful, but also wordy. As a gueiy only, inspect? cannot be used to send 
a waveform back to the oscilloscope. If you want to do this and you want the information guicMy you should 
instead use waveform. With waveform_setup it is possible to examine just a part of the waveform or a 
sparsed form of it. See the following pages 

If you're a BASIC user you might also find it convenient to use tnspect ? and waveform? together to 
construct files containing a version of the waveform descriptor that both you and BASIC can read. Using a 
stored waveform, this can be done in a format suitable for retransfer to Waverunner with mc:INSPECT? 
"WAVEDESC"; WAVEFORM?, and then placing the re^onse directly into a disk file. 



USE THE WAVEFORM QUERY 



Use the WAVEFORM? gueiy to transfer waveform data in block formats defined by the IE EE -488.2 standard. 
You can then download the response back to your Waverunner by using the waveform command. All your 
waveform's logical blocks can be read with the gueiy c i : waveform? Completeness, as well as time and 
space are the advantages of this approach when you have to read many waveforms with the same acguisition 
conditions, or when you are interested only in large amounts of raw integer data Moreover, you can choose 
any single block for reading with a gueiy such as c i : waveform? dat i . See Part Two for the various block 
names. 



You can place the binaiy response to a gueiy of the 
form Cl : waveform? or Cl : waveform? all 
in a disk file, then dump it using the G PIB bus D o 
this with default settings to show the hexadecimal 
and ASCII form, as on the following page. 



NOTE; A waveform query response can easily be 
a block containing over IB million bytes if it is in 
binary format, and twice as much if the HEX 
option is used. . — 
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Byte Offset 
Number 


Binary Contents in Hexadecimal 


ASCII Translation 
(.... = UNINTERESTING) 






































— 


0 






IT 


31 


3A 


57 


46 


20 


41 


4C 


4C 


2C 


23 


39 


30 


30 


30 




51 :WFALL, #900001 


16 






ko_ 


30 


34 


35 


3 of 
























OO450I 




0 














!I 


41 


56 


45 


44 


45 


53 


H 


00 


00 


00 


Mavedesc 


32 


11 




00 


00 


00 


00 


00 


E! 


45 


43 


52 


4F 


59 


5F 


32 


5F 


“3^ 


00 


LECROY 2 2. 


48 


27 




00 


00 


00 


00 


00 


00 


01 


00 


00 


00 


00 


01 


5Jd 


00 


00 


00 


64 


43 




00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


80 


59 




00 


00 


00 


00 


68 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


96 


75 




00 




45 


43 


52 


4F 


59 


39 


33 


37 


34 


4C^ 


00 


00 


00 


00 


.KaCROYLT344|. ... || 


112 


91 




00 


37 


84 


09 


40 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


128 


107 




00 


00 


00 


00 


00 


00 


00 


00 


34 


00 


00 


00 


34 


00 


00 


00 


144 


123 




32 


00 


00 


00 


00 


00 


00 


00 


33 


00 


00 


00 


00 


00 


00 


00 


160 


139 




01 


00 


00 


00 


00 


00 


00 


00 


01 


00 


00 


00 


01 


00 


00 


00 


176 


155 




00 


34 


83 


12 


6F 


3A 


OD 


8E 


C9 


46 


FE 


00 


00 


C7 


00 


00 


192 


171 




00 


00 


08 


00 


01 


32 


2B 


cc 


77 


BE 


6B 


A4 


BB 


51 


AO 


69 


208 


187 




BB 


BE 


6A 


D7 


F2 


AO 


00 


00 


00 


56 


00 


00 


00 


00 


00 


00 


224 


203 




00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


240 


219 




00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


256 


235 




00 


00 


00 


00 


00 


00 


00 


00 


00 


53 


00 


00 


00 


00 


00 


00 


272 


251 




00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


288 


267 




00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


304 


283 




00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


00 


40 


3B 


00 


320 


299 




00 


00 


00 


00 


00 


17 


OA 


05 


02 


07 


C8 


00 


00 


00 


00 


00 


336 


315 




00 


00 


00 


00 


00 


00 


00 


00 


01 


00 


OE 


00 


04 


3F 


80 


00 


352 


331 




00 


00 


OA 


00 


00 


3F 


80 


00 


00 


3A 


OD 


8E 


C9 


00 


00 




367 




0 
































11 


368 




1 


00 


13 


00 


04 


00 


FA 


00 


09 


00 


16 


00 


OB 


00 


F3 


00 


E8 


384 




17 


00 


08 


00 


IB 


00 


IB 


00 


FA 


00 


EC 


00 


05 


00 


IB 


00 


lA 


400 




33 


00 


FC 


00 


EC 


00 


05 


00 


14 


00 


18 


00 


03 


00 


F8 


00 


OD 


416 




49 


00 


15 


00 


14 


00 


03 


00 


F4 


00 


05 


00 


11 


00 


10 


00 


F8 


432 




65 


00 


FO 


00 


11 


00 


ID 


00 


IE 


00 


F9 


00 


EA 


00 


06 


00 


ID 


448 




81 


00 


18 


00 


FE 


00 


EE 


00 


07 


00 


19 


00 


18 


00 


03 


00 


FA 


464 




97 


00 


OA 


00 


16 


00 


11 


00 




















471 


(TamtHtnj 
















OA 



















Above To illustrate the contents of the logical blocks, the relevant parts have been separated. To 
make counting easier, the corresponding Byte Offset numbering has been restarted each time a new 
block begins. The A SCII translation, only part of which is shown, has been similarly split and 
hi^i^ted, showing how its parts correspond to the binary contents. 
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On the facing page... The first 10 bytes translate into ASCII and resemble the simple beginning of a query 
response. These are followed by the string #9000000450, the beginning of a binary block in which nine 
A^II integers are used to give the length of the block (450 bytes). The waveform itself starts immediately 
after this, at Byte 21. The very first byte is 0, as it is for the first byte in each block. 

The first object is a DESCRIPTOR NAME, a string of 16 characters with the value wavedesc. 

Then, 16 bytes after the beginning of the descriptor, at Byte 37, we find the beginning of the next string: the 
TEMPLATE_NAME with the value lecroy_2_2. 

Several other parameters follow. The INSTRUMENT NAME, lecroyltS 4 4, 76 bytes from the descriptor 
start (Byte 97), is easily recognizable. On the preceding line, 38 bytes after the descriptor (Byte 59), a four-byte 
integer gives the length of the descriptor: WAVE DESCRIPTOR = 00 00 01 5A (hex) = 346. 

At 60 bytes from the descriptor start (Byte 81) we find another four-byte integer giving the length of the data 
array: WAVEARRAYl = 00 00 00 68 (hex) = 104. 

And at 116 bytes after the descriptor (Byte 137), yet another four-byte integer gives the number of data points: 
WAVEARRAYCOUNT = 00 0000 34 (hex) = 52. 

Now we know that the data will start at 346 bytes from the descriptor's beginning (Byte 367), and that each of 
the 52 data points will be represented by two bytes The waveform has a total length of 346 -i 104, which is the 
same as the ASCII string indicated at the beginning of the block. The final OA at Byte 471 is the NL character 
associated with the GPIB message terminator <NLxEOI>. 

As the example was taken using an oscilloscope with an ei^t-bit AD C, we see the eight bits followed by a 0 
byte for each data point. However, for many other kinds of waveform this second byte will not be zero and will 
contain significant information. The data is coded in signed form (two's complement) with values ranging from 
-32768 = 8000 (hex) to 32767 = 7EEE (hex). If we had chosen to use the BYTE option for the data format, 
the values would have been signed integers in the range -128 = 80 (hex) to 127 = 7E (hex). The ADC values 
are mapped to the display grid in the following w^: 

0 is located on the grid's center axis 

127 (BYTE format) or 32767 (WO RD format) is located at the top of the grid 
-128 (BYTE format) or -32768 (WORD format) is located at the bottom of the grid. 

INTERPRET VERTICAL DATA 

Knowing now how to decipher the data, you m^ wish to convert it to the appropriate measured values. The 
vertical reading for each data point depends on the vertical gain and the vertical offset given in the descriptor. 
Eor accfuisition waveforms, tfds corre^onds to the volts/ div and voltage offset selected after conversion for 
the data representation being used. The template tells us that the vertical gain and offset can be found at Bytes 
156 and 160 and that they are stored as floating point numbers in the IEEE 32-bit format. An ASCII string 
giving the vertical unit is to be found in VE RTUNIT, Byte 196. The vertical value is given by the relationship: 
value = VERTICAL GAIN x data- VERTICAL O RESET, where: 
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VERTICALGAIN 


2.44141e-07 from the floating point number 3483 126f at Byte 177 


VERTICALOFFSET 


0.00054 from the floating point number 3A0D 8EC9 at Byte 181 


VERTICALUNIT 


V = volts from the string 5600 ... at Byte 217 



Therefore: 



since data[4] = FAOO = 64000 from the hexadecimal word FAOO at byte 371. Overflows 

the maximum. 16 bit value of 32767, so must be a negative value. Using 
the two's complement conversion 64000-216 = -1536 

value[4] = -0.000915 V as stated in the inject command. 

If the computer or the software available is not able to understand the IE E E floating point values, use the 
description in the template. 

The data values in a waveform m^ not all correspond to measured points EIRST_ VALID PNT and 
LAST VALID PNT give the necessary information. The descriptor also records the SPARSING EACTO R, 
the EIRST POINT, and the SEG MENT INDEX to aid interpretation if the options of the 
WAVEFORM_SETUP command have been used. 

Eor sequence acquisitions the data values for each segment are given in their normal order and the segments 
are read out one after the other. The important descriptor parameters are the WAVE ARRAY CO UNT and 
the SUBARRAY CO UNT, giving the total number of points and the number of segments 

Eor waveforms such as the extrema and the complex EFT there will be two art^s — one after the other — for 
the two of the result. 



CALCULATE A DATA POINT'S HORIZONTAL POSITION 



Each vertical data value has a corresponding horizontal position, usually measured in time or frequency units 
The calculation of this position depends on the type of waveform. Each data value has a position, i, in the 
original waveform, with i = 0 coire^onding to the first data point acquired. The descriptor parameter 
HO RUNIT gives a string with the name of the horizontal unit. 

Sngle Sweep waR^efomis: x[i] = HO RIZ_ INTERVAL x i + HORIZ OEESET. Eor acquisition waveforms 
this time is from the trigger to the data point in question. It will be different from acquisition to acquisition 
since the HO RIZ O EESET is measured for each trigger. In the case of the data shown above this means 



HORIZINTERVAL = 
HO RIZ O EESET = 

HORUNIT = S = 



le-08 from the floating point number 322b cell at Byte 194 

-5.149e-08 from the double precision floating point number be6b a4bb 
51a0 69bb at Byte 198 

seconds from the string 5300 ... at Byte 262 



This gives: x[0] = 

x[l] = 



-5.149^08 S 
-4.149^08 S. 



40 



I SSUE D : January 2002 



LTXXX-RCM-E Rev B 






Chapter Four: Understand and Manage Warefonns 



Sequence wavefoims: are really many independent acquisitions, so each segment will have its own horizontal 
offset. These can be found in the TRIGTIME array 

For the n'th segment: 

x[i,n] = HORIZ INTERVAL x i + TRIGGER_OFFSET[n]. 

The TRIGTIME array can contain up to 200 segments of timing information with two eight-byte double 
precision floating point numbers for each segment. 

RIS (Random Interleaved Sanqrling) waveforms: are composed of many acquisitions interleaved together. 
The descriptor parameter, RIS_ SWEEPS gives the number of acquisitions. The i'th point will belong to the 
m'th segment where: 

m = i modulo (RIS SWEEPS) will have a value between 0 and RIS SWEEPS -1. 

Then with: j = i - m 

x[i] = x[j,m] = HORIZ INTERVAL X j -I RIS_OFFSET[m], 

where the RIS O FFSETs can be found in the RISTIME art^. There can be up to 100 eight-byte double 
precision floating point numbers in this block. The instrument tries to get segments with times such that: 
RIS_OFFSET[i] s PIXEL OFFSET + {i- 0.5) x HORIZ INTERVAL. 



Thus, taking as an example a RIS with RIS SWEEPS = 10, HORIZ INTERVAL = 1 ns, and 
PIX FLO FFSET = 0.0, we might find for a particular event that: 


RIS_OFFSET[0] = -0.5ns 


RIS_OFFSET[l] = 0.4 ns 


RIS_OFFSET[2] = 1.6 ns 


RIS_OFFSET[3] = 2.6 ns 


RIS_OFFSET[4] = 3.4 ns 


RIS_OFFSET[5] = 4.5ns 


RIS_OFFSET[6] = 5.6 ns 


RIS_OFFSET[7] = 6.4 ns 


RIS_OFFSET[8] = 7.6 ns 


RIS_OFFSET[9] = 8.5 ns 



and therefore: 

x[0] = RISO FFSET[0] = -0.5 ns 

x[l]= RIS_OFFSET[l]= 0.4 ns 



x[9] = RISO FFSET[9] = 8.5 ns 

x[10] = 1 ns X 10 -I (-0.5) = 9.5 ns 

x[ll] = 1 ns X 10 -I- 0.4 = 10.4 ns 



x[19] = 1 ns ' 10 -I- 8.5 = 18.5 ns 

x[20] = 1 ns ' 20 -I (-0.5) = 19.5 ns. 
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USE THE WAVEFORM COMMAND 

Waveforms you read with the WAVEFO RM? query (page 37) 
can be sent back into your Wavemnner oscilloscope using 
WAVEFORM and related commands. Since the descriptor 
contains aU of the necessary information, you need not be 
concerned with any of the communication format parameters. 
The oscilloscope v^l learn all it needs to know from the 
waveform. 



TIP; Because wavefonm can only be sent 
back to Wbverunner memory traces (Ml 
M2, M3!, M4), consider removmg or 
changing the pr^ (Cl orCHANNEL_l) 
in the response tothewF? query See 
Part Two for examples. 




To ensure that the descriptor is coherent, however, when you synthesize waveforms for display or comparison 
read out a waveform of the appropriate size and then replace the data with the desired values. 

Here are among the many w^s to use waveform and its related commands to simplify or speed up work: 



Partial Waveform Readout: Use waveform_setup to specify a short part of a waveform for readout, as 
well as to select a sparsing factor for reading every n'th data point only. 

Byte Swapping: The comm_order command allows you to swap two bytes of data presented in 16-bit word 
format, in the descriptor or in the the data/ time arr^s, when sending the data via G PIB or RS-232-C ports. 

D epending on the computer system used, this will allow easier data interpretation. For Intel-based computers, 
you should send the data with the LSB first; the command should be cord lo. For Motorola-based 
computers, send the data with the MSB first (cord hi)— the default at power-up. 



NOTE: Data written to Whiverurmer hard disk or floppy drive, orto the optional PC memory card 
drive, will always remain in LSB Brst, the default DOS format Thus you carmot use the CORD 
cormnandin these cases, as it is only for data sent via the GPIB andRS-232-C ports. 



Data Length, Block Format, and Encoding: comm_format gives you control over these parameters. 

If you do not need the extra precision of the lower order byte of the standard data value, the BYTE option 
will enable you to save by a factor of two the amoimt of data transferred or stored. If the computer you are 
using cannot read binary data, the HEX option allows a response form in which the value of each byte is given 
by a pair of hexadecimd digits 

Data-Oidy Transfers: comm_header off enables a response to wf ? dat i with data only (the c i : wf 
DAT i will disappear). If you have also ^ecified comm_format off, byte, bin, the re^onse will be 
data bytes only (the #90000nnnnnwill disappear — see page 38). 

Formatting for RS-232-C Users: The CO MM RS232 command can assist by splitting the very long WF? 
response into individual lines 
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Transfer W^n/efomis at Hi^ Speed 

You must take several important factors into account if you wish to achieve maximum, continuous data 
transfer rates from your Waverunner oscilloscope to the external controller. The single most important of 
these is to limit the amount of work done in the computer. This means that you should avoid writing data to 
disk wherever possible, niinimize operations such as per-data-point computations, and reduce the number of 
calls to the 1/ 0 system. To do this, you can try the following: 

Reduce the number of points to be transfened and the number of data bytes perpoint The pulse 
parameter capability and the processing functions can save a great deal of computing and a lot of data 
transfer time if employed creatively. 

Attenqjt to overlap waveform acquisition with waveform transfer. The oscilloscope is enable of 
transferring an already acquired or processed waveform after a new acquisition has been started. The total 
time that Waverunner takes to acquire events will be considerably increased if it is obliged to wait for 
triggers (livetime). 

Minimize the number of waveform transfers by using Sequence mode to accumulate many triggers 
for each transfer. This is preferable to using waveform_setup to reduce the number of data points for 
transfer. It also significantly reduces oscilloscope transfer overhead. For example, you could use 
ARM; WAi T ; c 1 : WF ? (wait for the event, transfer the data, and then start a new acquisition). You 
could also "loop" this line in the program as soon as it has finished reading the waveform. 
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Chapter Five: Check Wavi^onn Status 
In this ch^ter, see how 
To use status registers 
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Chapter Five 



Check Waveform Status 



Use Status Registers 

A wide range of status registers allows you to guickly determine Waverunner internal processing status at any 
time. These registers and the oscilloscope's status reporting system, which group related functions together, are 
designed to comply with IEEE 488.2 recommendations Some, such as the Status Byte Register (STB) or the 
Standard Event Status Register (ESR), are reguired by the IEEE 488.2 Standard. Others are device ^ecific, 
including the Command Error Register (CMR) and Execution Error Register (EXR). Those commands 
associated with IEEE 488.2 mandatory status registers are preceded by an asterisk (*). 

OVERVIEW 

The Standard Event Status Bit (ESB) and the Internal Status Change Bit (INB) in the SBR are summary bits of 
the ESR and the Internal State Change Register (INR). The Message Available Bit (MAV) is set whenever there 
are data bytes in the output gueue. The Value Adapted Bit (VAB) indicates that a parameter value was adapted 
during a previous command interpretation. Eor example, if the command TD IV 2.5 US was received, the 
timebase would be set to 2 ms/ div along with the VAB bit. 

The Master Summary Status bit (MSS) indicates a request for service from the oscilloscope. You can only set 
the MSS bit if you have enabled one or more of the other STB bits with the Service Request Enable Register 
(SRE). 

All Enable registers (SRE, ESE and INE) are used to generate a bit-wise AND with their associated status 
registers. The logical C R of this operation is reported to the STB register. At power-on, all Enable registers are 
zero, inhibiting any reporting to the STB. 

The E SR primarily summarizes errors, whereas the INR reports internal changes to the instrument. Additional 
details of errors reported by ESR can be obtained with the queries cmr?, ddr?, exr? andURR?. 

The register structure contains one additional register, not shown on the next page (Eigl). This is the Parallel 
Poll Enable Register (PRE), which behaves exactly like the SRE, but sets the "ist" bit used in the Parallel PoU. 
Read the "ist" bit with the * i s t ? query. 

Exanqile: If you were to send the erroneous command TRIGMAKE SINGLE to your Waverunner, the 
oscilloscope would reject it and set the Command Error Register (CMR) to the value 1 (unrecognized 
command/ query header). The non-zero value of CMR would be reported to Bit 5 of the Standard Event 
Status Register (E SR), which is then set. N othing further would occur unless the corre^onding Bit 5 of the 
Standard Event Status E nable Register (E SE ) was set with the command * e s e 32, enabling Bit 5 of E SR to 
be set for reporting to the summary bit E SB of the STB. 



LTXXX-RCM-E Rev B 



I SSUE D : January 2002 



45 




Logical OR 




Figure 1. Status Register Structure 
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If you enabled the setting of the E SB summaiy bit in STB, again nothing would occur unless you enabled 
further reporting by setting the corresponding bit in the Service Request Enable Register with the command 
*SRE 32. The generation of a non-zero value of CMR would ripple throuch to MSS, generating a Service 
Request (SRQ). 

You can read the value of CMR and simultaneously reset to zero at any time with the command cmr? . The 
occurrence of a command error can also be detected by analyzing the response to * e s R ? . However, if you 
must survey several types of potential errors, it is usually far more efficient to enable propagation of the errors 
of interest into the STB with the enable registers E SE and INE . 

To summarize: a command error (CMR) sets Bit 5 of E SR if 

a Bit 5 of ESE is set, ESB of STB is also set, or 

b. Bit 5 of SRE is set, MSS/ RQ S of STB is also set and a Service Request is generated. 

STATUS BYTE REGISTER (STB) 

STB is the Waverunner central reporting structure. It is made up of eight single-bit summary messages, three 
of which are unused, that reflect the current status of the oscilloscope's associated data structures: 

Bit 0 is the INB summary bit of the Internal State Change Register. It is set if any INR bits are set, 
provided they are enabled by the corresponding bit of the INE register. 

Bit 2 is the VAB bit, indicating that a parameter value was adapted during a previous command 
interpretation. 

Bit 4 is the MAV bit, indicating that the interface output queue is not empty. 

Bit 5 is the summary bit E SB of the E SR. It is set if any of the bits of the E SR are set, provided they are 
enabled by the corresponding bit of the E SE register. 

Bit 6 is either the MSS or RQ S (Request for Service) bit. 

You can read the STB using the * s tb ? query. It reads and clears the STB, in which case Bit 6 is the MSS bit. 
And it indicates whether the oscilloscope has any reason to request service. The response to the query 
represents the binary weighted sum of the register bits. The register is cleared by *stb?, alst?, *cls, or 
with Waverunner powering up. 

Another way to read the STB is using the serial poll (see Chapter 2). In this case. Bit 6 is the RQ S bit, indicating 
that the instrument has activated the SRQ line on the G PIB. The serial poll clears only the RQ S bit. And the 
STB's MSS bit, and any other bits which caused MSS to be set, will remain set after the poll. These bits must be 
reset. 

STANDARD EVENT STATUS REGISTER (ESR) 

E SR is a 16-bit register reflecting the occurrence of events. E SR bit assignments have been standardized by 
IEEE 488.2. Q nly the lower eight bits are currently in use. 



LTXXX-RCM-E Rev B 



I SSUE D : January 2002 



47 




Read E SR using * E s R ? . The response is the binary wei^ted sum of the register bits. The register is cleared 
with *ESR? orALST?, orwith *CLS or powering on the scope. 

Exanqile: The response message * E s R 160 tells you that a command error occurred and that the E SR is 
being read for the first time after power-on. The value 160 can be broken down into 128 (Bit 7) plus 32 (bit 5). 
See the table with the e s R command description in Part Two for the conditions corresponding to the bits set. 

The Power 0 N bit appears only on the first *esr? guery after power-on, as the guery clears the register. You 
can determine this type of command error by reading the CMR with cmr ? . It is not necessary that you read, 
or simultaneously clear, this register in order to set the CMR bit in the E SR on the next command error. 

STANDARD EVENT STATUS ENABLE REGISTER (ESE) 

This register allows you to report one or more events in the E SR to the E SB summary bit in the STB. 
ModifyESE with *ese and clear it with *ese 0, or with power-on. Read it with *ese?. 

Exanqile: Use *ese 4 to set bit 2 (binary 4) of the ESE Register, and enable guery errors to be reported. 

SERVICE REQUEST ENABLE REGISTER (SRE) 

SRE specifies which Status Byte Register summary bit or bits will bring about a service reguest. This register 
consists of ei^t bits Setting a bit allows the summary bit located at the same bit position in the SBR to 
generate a service reguest, provided that the associated event becomes true. Bit 6 (MSS) cannot be set and is 
always reported as zero in response to * s re ? . 

Modify SRE with * sre and clear it with * sre 0, or with power-on. Read it using * sre ? . 

PARALLEL POLL ENABLE REGISTER (PRE) 

This specifies which Status Byte Register summary bit or bits will set the "ist" individual local message. PRE is 
similar to SRE, but is used to set the parallel poll "ist" bit rather than MSS 

The value of the "ist" may also be read without a Parallel Poll via the guery * i s t ? . The response indicates 
whether or not the "ist" message has been set (values are 1 or 0). 

Modify PRE * p re and clear it with * p re O , or with power-on. Read this register with * p re ? . 

Exanqile: Use *pre 5 to set the register's bits 2 and 0 (decimal 4 and 1). 

INTERNAL STATE CHANGE STATUS REGISTER (INR) 

INR reports the completion of a number of internal operations (the events tracked by this 16-bit- wide register 
are list^ with the i nr? description in Part Two). 

Read the register using i nr ? . The response is the binary weighted sum of the register bits. Clear the register 
with INR? orALST?, a *cls command, orwith power-on. 
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INTERNAL STATE CHANGE ENABLE REGISTER (INE) 

INE allows one or more events in the Internal State Change Status Register to be reported to the INB 
summary bit in the STB. 

Modify INE with INE and clear it with ine 0, or after power-on. Read it with ine?. 

COMMAND ERROR STATUS REGISTER (CMR) 

This register contains the code of the last command error detected by the oscilloscope. List these error codes 
using CMR?. 

Read CMR with cmr? . The response is the error code. Clear the register with a cmr? or alst ? gueiy a 
*CLS command, or with power-on. 

DEVICE DEPENDENT ERROR STATUS REGISTER (DDR) 

DDR indicates the type of hardware errors affecting your Waverunner. Individual bits in this register report 
specific hardware failures. List them using ddr? . 

Also read this register using the ddr? gueiy. The response is the binary weighted sum of the error bits. Clear 
it with another DDR? orwithALST?, a*CLS command, or with power-on. 

EXECUTION ERROR STATUS REGISTER (EXR) 

EXR contains the code of the last execution error detected by the oscilloscope. List these error codes with 

EXR?. 

Read the register, again using the exr? gueiy. The response is the error code. Clear with another exr? or 
with ALST?, a *CLS command, or with power-on. 



USER REQUEST STATUS REGISTER (URR) 

Einally URR contains the identification code of the last menu button pressed. List these codes with urr?. 

Read URR using the same gueiy The response is the decimal code associated with the selected menu button. 
And clear the register with another urr ? , or with al s t ? , a *CLS command, or with power-on. 

m 



LTXXX-RCM-E Rev B 



I SSUE D : January 2002 



49 




BLANK PAGE 



50 



I SSUE D : January 2002 



LTXXX-RCM-E Rev B 




Chapter Five: Check Wavefoim Status 



BLANK PAGE 



LTXXX-RCM-E Rev B 



I SSUE D : January 2002 



51 







Part Two 

COMMANDS 



PaitTwo lists and describes the commands and queries you will need to remotely operate your 
Wavenmner oscilloscope. 
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Part Two: COMMANDS 

In this part of the manual, you'll find the commands and queries. 
To run W^runner remotely. 



52 



I SSUE D : January 2002 



LTXXX-RCM-E Rev B 





Part 



Two: 



COMMANDS 



Use W^eruimer Conimands and Queries 

This part of the manual lists and describes the remote control commands and queries recognized by 
Waverunner. You can execute all of them in either local or remote state. Where commands or queries for 
special options are not included, you will find them in those options' dedicated Opaatcr's Manuals 

The commands and queries are listed in alphabetical order according to the long form of their name. For 
example, the description of attenuation, whose short form is attn, is listed before that of auto 
SETUP, whose short form is aset. Each command or query description starts on a new page. The name 
(header) is given in both long and short form at the top of the first page of each description. 

Queries perform actions such as obtaining information. They are recognized by ? following their headers. 
Many commands can be used as queries with the question mark added. 

A brief explanation of the operation performed by the command or query is followed the formal syntax, with 
the full-name header given in lower-case characters and the short form derived from it in upper-case characters 
(e.g., D o T_ j o i N f or D T JN ) . Where applicable, the syntax of the query is given with the format of its 
response. A short example illustrating a typical use is iso presented. The G PIB examples assume that the 
controller is equipped with a National Instruments interface board, which calls to the related interface 
subroutines in BASIC. The device name of the oscilloscope is defined as SCOPE%. 

Use the two tables that precede the descriptions to quickly find a command or query. The first of these lists the 
commands and queries in alphabetical order according to their short form. The second table groups them 
according to the subsystem or category they belong to. 

COMMAND NOTATION 

The following notation is used in the commands: 

< > Angular brackets enclose words that are used as placeholders, of which there are two types: the header 
path and the data parameter of a command. 

: = A colon followed by an equals sign separates a placeholder from the description of the type and range 
of values that can be used in a command instead of the placeholder. 

{ } Braces enclose a list of choices, one of which must be made. 

[ ] Square brackets enclose optional items. 

An ellipsis indicates that the items left and right of it can be repeated any number of times. 
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Exanqile: consider the syntax notation for the command to set the vertical input sensitivity: 

1. <channel> : volt_div <v_gain> 

2. <channel> : = {ci, C2} 

3. <v_gatn> : = 5.0 mV to 2.5 V 

The first line shows the formal appeaiunce of the command: <channel> denotes the placeholder for the 
header path; <v_gain> is the placeholder for the vertical gain value. 

The second line indicates that either c i or c 2 must be chosen for the header path. 

The third line means that the actual vertical gain can be set to any value from 5 mV to 2.5 V. 
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Table of Commands and Queries — By Shoit Foim... 



Page 

No. 


Short 

Form 


Long Form 


Subsystem 

(CATEGORY) 


WliAT THE Command or Query Does 




ACAL 


AUTO_CALIBRATE | 


MISCELLANEOUS | 


Enables or disables automatic calibrabon. 




ALST? 


ALL_STATUS? | 


STATUS 1 


Reads and cleats the contents of all status registers. 


64 1 


ARM 1 


ARM„ACQUISITION | 


ACQUISITION I 


Changes acquisition state from "stopped" to "single". 


67 J 


ASCR 1 


AUTO_SCROLL | 


DISPLAY I 


Controls the Auto Scroll viewing feature. 


68 1 


ASET _) 


AUTO_SETUP 1 


ACQUISITION 1 


Adjusts vertical, timebase and trigger parameters. 


65 1 


ATTN 1 


ATTENUATION | 


ACQUISITION 1 


Selects the vertical attenuation factor of the probe. 


71 1 


BUZZ _J 


BUZZER 1 


MISCELLANEOUS | 


Controls the built-in piezo-electric buzzer. 


69 1 


BWL { 


BANDWIDTH_LIMIT | 


ACQUISITION 1 


Enables/ disables bandwidth-limiting low-pass filter. 


72 1 


*CAL? 1 


*CAL? 1 


MISCELLANEOUS | 


Performs complete internal calibration of oscilloscope. 


84 1 


CFMT 1 


COMM„FORMAT | 


COMMUNICATION | 


Selects the format for sending waveform data 


86 1 


CHDR 1 


COMM_HEADER | 


COMMUNICATION | 


Controls formatting of query responses. 


87 1 


CHLP 1 


COMM_HELP 1 


COMMUNICATION | 


Controls operational level of the RC Assistant. 


88 1 


CHL 1 


COMM_HELP_LOG | 


COMMUNICATION | 


Returns the contents of the RC Assistant log. 


74 1 


CHST 1 


CALL_HOST 1 


DISPLAY I 


Allows manual generation of a service request (SRQ ). 


75 i 


CLM ) 


CLEAR_MEMORY | 


FUNCTION 1 


Clears the specified memory. 


77 1 


*CLS 1 


*CLS 1 


STATUS 1 


Clears aU status data registers. 


76 i 


CLSW 1 


CLEAR_SWEEPS | 


FUNCTION 1 


Restarts the cumulative processing functions. 


78 1 


CMR? 1 


CMR? 1 


STATUS 1 


Reads and clears the Command error Register (CMR). 


80 1 


COLR 1 


COLOR 1 


DISPLAY 1 


Selects color of individual on-screen objects. 


89 1 


CORD 1 


COMM_ORDER | 


COMMUNICATION | 


Controls the byte order of waveform data transfers. 


91 1 


CORS 1 


COMM_RS232 | 


COMMUNICATION | 


Sets remote control parameters of the RS-232-C port. 


73 1 


GOUT 1 


CAL_OUTPUT 1 


MISCELLANEOUS | 


Sets signal type put out at the CAL connector. 


94 1 


CPL J 


COUPLING 1 


ACQUISITION 1 


Selects the specified input channel's coupling mode. 


95 1 


CRMS 1 


CURSOR_MEASURE | 


CURSOR 1 


Specifies the type of cursor/ parameter measurement. 


98 1 


CRST? 1 


CURSOR_SET? 1 


CURSOR 1 


Allows positioning of any one of eight cursors. 


100 1 


CRVA? 1 


CURSOR_VALUE? | 


CURSOR 1 


Returns trace values measured by specified cursors. 


83 1 


CSCH 1 


COLOR_SCHEME | 


DISPLAY I 


Selects the display color scheme. 


103 1 


DATE 1 


DATE 1 


MISCELLANEOUS | 


Changes the daW time of the internal real-time clock. 


104 1 

106 1 


DDR? 1 

DEF 1 


DDR? 1 


STATUS 1 


Reads, clears the D evice D ependent Register (DDR). 


DEFINE 1 


FUNCTION 1 


Specifies math expression for function evaluation. 


112 1 


DELF 1 


DELETE_FILE | 


MASS STORAGE j 


Deletes files from mass storage. 


113 1 


DIR 1 


DIRECTORY | 


MASS STORAGE j 


Creates and deletes file directories. 


216 J 


DISP 1 


DISPLAY 1 


DISPLAY I 


Controls the display screen. 


102 1 


DPNT 1 


DATA_POINTS | 


DISPLAY 1 


Controls bold/ single pixel display of sample points. 


116 ! 


DTJN 1 


DOT_JOIN 1 


DISPLAY I 


Controls the interpolation lines between data points. 


117 t 


DZOM _J 


DUAL_ZOOM 1 


DISPLAY I 


Sets horizontal magnification and positioning. 


118 1 


EKEY 1 


ENABLE_KEY | 


DISPLAY I 


Allows use of the KEY command in local mode. 
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Page 

No. 


SlORT 

Form 


Long Form 


Subsystem 

(CATEGORY) 


WliAT THE Command or Query Does 


119 


*ESE 


*ESE 


STATUS 


Sets the Standard Event Status Enable registeitESE). 


120 


*ESR? 


*ESR? 


STATUS 


Reads, dears the Event Status Register (ESR). 


123 


EXR? 


EXR? 


STATUS 


Reads, dears the Execution error Register (EXR). 


125 


FATC 


FAT_CURSOR 


DISPLAY 


Controls width of cursors. 


127 


FCR 


FIND_CTR_RANGE 


FUNCTION 


Automatically sets the center and width of a histogram. ! 


128 


FCRD 


FORMAT_CARD 


MISCELLANEOUS 


Eormats the manory card. 


130 


FFLP 


FORMAT_FLOPPY 


MISCELLANEOUS 


Eormats a floppy disk. 


132 


FHDD 


FORMAT_HDD 


MASS STORAGE 


Eormats the removable hard disk. 


126 


FLNM 


FILENAME 


MASS STORAGE 


Changes default filenames. 


135 


FRST 


FUNCTION_RESET 


EUNCTION 


Resets a waveform-processing function. 


134 


FSCR 


FULL_SCREEN 


DISPLAY 


Selects magnified view format for the grid. 


136 


GBWL 


GLOBAL_BWL 


ACOUISITION 


Enables/ disables the G lobal Bandwidth Limit. 


137 


GRID 


GRID 


DISPLAY 


Specifies single-, dual- or quad- mode grid display. 


138 


HCSU 


HARDCOPY_SETUP 


HARD COPY 


Configures the hardcopy driver. 


141 


HCTR 


HARDCOPY_TRANSMIT 


HARD COPY 


Sends string of ASCII characters to hardcopy unit. 


142 


HMAG 


HOR_MAGNIFY 


DISPLAY 


Horizontally expands the selected ecpansion trace. 


143 


HPOS 


HOR_POSITION 


DISPLAY 


Horizontally positions intensified zone's center. 


145 


*IDN? 


*IDN? 


MISCELLANEOUS 


Eor identification purposes. 


152 


ILVD 


INTERLEAVED 


ACOUISITION 


Enables/ disables random interleaved sampling (RIS). 


146 


INE 


INE 


STATUS 


Sets the Internal state change Enable register (INE). 


147 


INR? 


INR? 


STATUS 


Reads, clears INtemal state change Register (INR). 


149 


INSP? 


INSPECT? 


WAVEEORM 

TRANSEER 


Allows acquired waveform parts to be read. 


151 


INTS 


INTENSITY 


DISPLAY 


Sets the grid or trace/ text intensity level. 


153 


1ST? 


1ST? 


STATUS 


Reads the current state of the IEEE 488. 


154 


KEY 


KEY 


DISPLAY 


D isplays a string in the menu field. 


155 


LOGO 


LOGO 


DISPLAY 


Displays LeCroy logo at top of grid. 


156 


MASK 


MASK 


CURSOR 


Invokes Polymask draw and fill tools. 


158 


MGAT 


MEASURE_GATE 


DISPLAY 


Controls highlighting of the measurement gate region. 


160 


MSG 


MESSAGE 


DISPLAY 


D isplays a string of characters in the message field. 


159 


MSIZ 


MEMORY_SIZE 


ACOUISITION 


Selects max. memory length. 


161 


MZOM 


MULTI_ZOOM 


DISPLAY 


Sets horizontal magnification and positioning. 


162 


OFST 


OFFSET 


ACOUISITION 


Allows output channel vertical offset adjustment. 


163 


*OPC 


*OPC 


STATUS 


Sets the OPC bit in the Event Status Register (ESR). 


164 


*OPT? 


★OPT? 


MISCELLANEOUS 


Identifies oscilloscope options. 


167 


PACL 


PARAMETER_CLR 


CURSOR 


Clears all current parameters in Custom, Pass/ Pail. 


168 


PACU 


PARAMETER_CUSTOM 


CURSOR 


Controls parameters with customizable qualifiers. 


171 


PADL 


PARAMETER_DELETE 


CURSOR 


Deletes a specified parameter in Custom, Pass/ Pail. 


172 


PAST? 


P ARAMETER_S TAT I ST I C S ? 


CURSOR 


Returns current statistics parameter values. 




PAVA? 


PARAMETER_VALUE ? 


CURSOR 


Returns current parameter, mask test values. 
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(category) 


WliAT THE Command or Query Does 


183 


PECS 1 


PER_CURSOR_SET j 


CURSOR 1 


Positions independent cursors. I 


185 1 


PECV? 1 


PER_CURSOR_VALUE ? | 


CURSOR I 


Returns values measured by cursors. | 


188 1 


PELT 1 


PERSIST_LAST | 


DISPLAY 


Shows the last trace drawn in a persistence data map. 


186 1 


PERS 1 


PERSIST 1 


DISPLAY 


Enables or disables the persistence display mode. 


187 1 


PECL 1 


PERSIST_COLOR | 


DISPLAY 


Controls color rendering method of persistence traces. 


189 1 


PESA 1 


PERSIST_SAT 1 


DISPLAY 


Sets the color saturation level in persistence. 


190 1 


PESO 1 


PERSIST_SETUP | 


DISPLAY 


Selects display persistence duration. 


176 1 


PECO 1 


PAS S_FAI L_COND I T ION | 


CURSOR 


Adds a Pass/ Fail test condition or custom parameter. 


178 1 


PFCT 1 


PAS S_FAI L_COUNTER 


CURSOR 


Resets the Pass/ Fail acquisition counters. 


179 1 


PFDO 1 


PASS_FAIL_DO 


CURSOR 


Defines desired outcome, actions after Pass/ Fail test. 


181 1 


PFMS 1 


PAS S_FAI L_MASK 


CURSOR 


G enerates tolerance mask on a trace and stores it. 


182 1 


PFST? 1 


PAS S_FAIL_STATUS ? 


CURSOR 


Returns the Pass/ Fail test for a given line number. 


166 1 


PNSU i 


PANEL_SETUP 


SAVE/ RECALL 


Complements the *SAV/ *RST commands. 


191 1 


*PRE 1 


*PRE 


STATUS 


Sets the PaRallel poll Enable register (PRE). 


192 1 


PRCA? 1 


PROBE_CAL? 


PROBES 


Performs auto-calibration of connected current probe. 


193 1 


PRDG? 1 


PROBE_DEGAUSS? 


PROBES 


Degausses, calibrates connected current probe. 


194 1 


PRNA 1 


PROBE_NAME? 


PROBES 


Names the probe connected to the oscilloscope. 


195 1 


*RCL 1 


*RCL 


SAVE/ RECALL 


Recalls one of five non-volatile panel setups. 


198 1 


RCPN 1 


RECALL_PANEL 


SAVE/ RECALL 


Recalls a front panel setup from mass storage. 


197 1 


REC 1 


RECALL 


WAVEEORM 

TRANSEER 


Recalls a file from mass storage to internal memory. 


196 [ 


ROUT [ 


REAR_OUTPUT 


MICELLANEOUS 


Sets the type of signal put out at rear BN C connector. 


199 t 


*RST 1 
*SAV [ 


*RST 


SAVE/ RECALL 


Initiates a device reset. 


201 1 


*SAV 


SAVE/ RECALL 


Stores current state in non-volatile internal memory. 


202 1 


SCDP 1 


SCREEN_DUMP 


HARD COPY 


Causes a screen dump to the hardcopy device. 


200 1 


SCLK 1 


SAMPLE_CLOCK 


ACOUISITION 


Allows control of an external timebase. 


203 1 


SCSV 1 


SCREEN_SAVE 


DISPLAY 


Controls the automatic screen saver. 


204 1 


SEL 1 


SELECT 


DISPLAY 


Selects the specified trace for manual display control. 


205 1 


SEQ 1 


SEQUENCE 


ACOUISITION 


Sets the conditions for the sequence mode acquisition. 


207 I 


SLEEP 1 


SLEEP 


MICELLANEOUS 


Makes the scope wait brfore it interprets new 
commands 


208 1 


*SRE 1 


*SRE 


STATUS 


Sets the Service Request Enable register (SRE). 


209 1 


*STB? 1 


*STB? 


STATUS 


Reads the contents of the IEEE 488. 


212 1 


STO I 


STORE 


WAVEEORM 

TRANSEER 


Stores a trace in internal manory or mass storage. 


211 1 


STOP 1 


STOP 


ACOUISITION 


Immediately stops signal acquisition. 


^ i 


STPN 1 


STORE_PANEL 


SAVE/ RECALL 


Stores front panel setup to mass storage. 


214 1 


STST I 


STORE_SETUP 


WAVEEORM 

TRANSEER 


Controls the way in which traces are stored. 


215 1 


STTM I 


STORE_TEMPLATE 


WAVEFORM 

TRANSFER 


Stores the waveform tanplate to mass storage. ! 
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218 


TDIV 1 


TIME_DIV 


ACQUISITION 


Modifies the timebase setting. 


216 


TDISP 1 


TDISP 


MISCELLANEOUS 


Changes time display from current to trigger or none. | 


217 


TMPL? 


TEMPLATE? 


WAVEEORM 

TRANSEER 


Produces a complete waveform tanplate copy. | 


219 


TRA ! 


TRACE 


DISPLAY 


E nables or disables the display of a trace. 


220 


TOPA 


TRACE_OPACITY 


DISPLAY 


Controls the opacity of the trace color. 


222 


TRCP 


TRIG_COUPLING 


ACQUISITION 


Sets the coupling mode of the specified trigger source. 


223 


TRDL 


TRIG_DELAY 


ACQUISITION 


Sets the time at which the trigger is to occur. 


221 


*TRG 


*TRG 


ACQUISITION 


Executes an ARM command. 


225 


TRLV 


TRIG_LEVEL 


ACQUISITION 


Adjusts the trigger level of the specified trigger source. ' 


226 


TRMD 


TRIG_MODE 


ACQUISITION 


Specifies the trigger mode. 


227 


TRSE 


TRIG_SELECT 


ACQUISITION 


Selects the condition that wHl trigger acquisition. 


230 


TRSL 


TRIG_SLOPE 


ACQUISITION 


Sets the trigger slope of the specified trigger soirrce. 


231 


TRWI 


TRIG_WINDOW 


ACQUISITION 


Sets window amplitude on current Edge trigger source. 


232 


*TST? 


*TST? 


MISCELLANEOUS 


Performs an internal self-test. i 


233 


URR? 1 


URR? 


STATUS 


Reads, clears User Request status Register (URR). 


237 


VDIV 


VOLT_DIV 


ACQUISITION 


Sets the vertical sensitivity. 


235 


VMAG 


VERT_MAGNIFY 


DISPLAY 


V ertically expands the specified trace. 


236 


VPOS 


VERT_POSITION 


DISPLAY 


Adjusts the vertical position of the specified trace. 


238 


*WAI 


*WAI 


STATUS 


Required by the IEEE 488. 


239 


WAIT 


WAIT 


ACQUISITION 


Prevents new analysis imtil current is completed. 


240 


WF 1 


WAVEFORM 


WAVEEORM 

TRANSEER 


Transfers a waveform from controller to scope. 


243 


WFSU 


WAVEFORM_SETUP 


WAVEEORM 

TRANSEER 


Specifies amount of waveform data to go to controller. 


245 


WFTX 


WAVEFORM_TEXT 


WAVEEORM 

TRANSEER 


Documents acquisition conditions. 


246 


XYAS? 


XY_ASSIGN? 


DISPLAY 


Returns traces currently assigned to the XY display. 


247 


XYCO 


XY_CURSOR_ORIGIN 


CURSOR 


Sets origin position of absolute cursor measurements. 


248 


XYCS 


XY_CURSOR_SET 


CURSOR 


Allows positioning of X Y voltage cursors. 


250 


XYCV? 


XY_CURSOR_VALUE ? 


CURSOR 


Returns the current values of the X vs Y cursors. ' 


252 


XYDS 


XY_DISPLAY 


DISPLAY 


Enables or disables the XY display mode. 


253 


XYRD 


XY_RENDER 


DISPLAY 


Controls XY plot: smooth or disconnected points. | 


254 


XYSA 1 


XY_SATURATION 


DISPLAY 


Sets persistence color saturation level in XY display. | 
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Table of Commands and Queries — By Subsystem... 



Page 


SlORT 




Long Form 


WRat the Command or Query Does 


No. 


Form 














ACQUISTTION - 


- To Control Waveeorm Capture 


64 


ARM 


ARM_ACQUI S I T I ON 


1 Changes acquisition state from "stopped" to "single" . 


68 


ASET ! 


AUTO_SETUP 


1 Adjusts vertical, timebase and trigger parameters for signal display. 


65 


ATTN 1 


ATTENUATION 


1 Selects the vertical attenuation factor of the probe. 


69 


BWL 


J 


BANDWIDTH_LIMIT 


1 Enables or disables the bandwidth-limiting low-pass filter. 


136 


GBWL 1 


GLOBAL_BWL 


1 E nables/ disables the G lobal Bandwidth Limit 


152 


ILVD 


J 


INTERLEAVED 


1 Enables or disables random interleaved sampling (RIS). 


159 


MSIZ 1 


MEMORY_SIZE 


1 Allows selection of maximum memory length (M- and L-models only). 






OFFSET 


1 Allows vertical offset adjustment of the specified input channel. 






SAMPLE_CLOCK 


1 Allows control of an external timebase. 


205 


SEQ 1 


SEQUENCE 


1 Sets the conditions for Sequence-mode acquisition. 


211 


STOP 1 


STOP 


1 Immediately stops signal acquisition. 


218 


TDIV 1 


TIME_DIV 


1 Modifies the timebase setting. 


222 


TRCP 1 


TRIG_COUPLING 


1 Sets the coupling mode of the specified trigger source. 


223 


TRDL 1 


TRIG_DELAY 


1 Sets the time at which the trigger is to occur. 


221 


*TRG 1 


*TRG 


1 Executes an ARM command. 


225 


TRLV 


J 


TRIG_LEVEL 


1 Adjusts the level of the specified trigger source. 


226 


TRMD 


J 


TRIG_MODE 


1 Specifies T rigger mode. 


227 


TRSE 1 


TRIG_SELECT 


1 Selects the condition that will trigger acquisition. 


230 


TRSL 


J 


TRIG_SLOPE 


1 Sets the slope of the specified trigger source. 


231 


TRWI 1 


TRIG_WINDOW 


1 Sets the window amplitude in volts on the current E dge trigger source. 


237 


VDIV 


VOLT_DIV 


1 Sets the vertical sensitivity in volts/ div. 


239 


WAIT 


WAIT 


1 Prevents new command analysis until current acquisition completion. 




COMMUNICATION - 


To &:t Communication Characteristics 


[ 84 


CFMT 




COMM_FORMAT 


1 Selects the format to be used for sending waveform data 


86 


CHDR 




COMM_HEADER 


1 Controls formatting of query responses. 


87 


CHLP 


1 


COMM_HELP 


1 Controls operational level of the RC Assistant. 


88 


CHL 


J 


COMM_HELP_LOG 


1 Returns the contents of the RC A ssistant log. \ 


89 


CORD 


J 


COMM_ORDER 


1 Controls the byte order of waveform data transfers. | 


91 


CORS 


J 


COMM_RS232 


1 Sets remote control parameters of the RS-232-C port. | 








CURSOR- 


To Pereorm Measurements 


r 95 


CRMS 


J 


CURSOR_MEASURE 


1 Specifies the type of cursor or parameter measurment for display. 


98 


CRST? 


J 


CURSOR_SET? 


1 Allows positioning of any one of eight independent cursors. | 


100 


CRVA? 


J 


CURSOR_VALUE? 


1 Returns the values measured by the specified cursors for a given trace. 


156 1 


MASK 


J 


MASK 


1 Invokes Polymask draw and fill tools. 


167 


PACL 


1 


PARAMETER_CLR 


1 Clears all current parameters in Custom and Pass/ Pail modes. 


171 


PADL 


1 


PARAMETER_DELETE 


1 D eletes a specified parameter in Custom and Pass/ Pail modes. 
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172 


PAST? 


PARAMETER_STATISTICS? 


Returns current statistics values for the specified pulse parameter. 


173 


PAVA? 


1 PARAMETER_VALUE? 


Returns current values) of parameterts) and mask tests. 


183 


PECS 


1 PER_CURSOR_SET 


Allows positioning of any one of six independent cursors. 


185 


PECV? 


1 PER_CURSOR_VALUE? 


Returns the values measured by specified cursors for a given trace. 


176 


PECO 


1 PASS_FAIL_CONDITION 


Adds a Pass/ Fail test condition or custom parameter to display. i 


178 


PFCT 


1 PASS_FAIL_COUNTER 


Resets the Pass/ Fail acquisition counters. 


179 


PFDO 


1 PASS_FAIL_DO 


D efines the desired outcome and actions following a Pass/ Fail test. 


181 


PFMS 


1 PASS_FAIL_MASK 


G enerates a tolerance mask around a chosen trace and stores it. 


182 


PFST? 


1 PASS_FAIL_STATUS? 


Returns the Pass/ Fail test for a given line number. 


247 


XYCO 


1 XY_CURSOR_ORIGIN 


Sets position of origin for absolute cursor measurements on X Y display. 


248 


XYCS 


1 XY_CURSOR_SET 


Allows positioning of any one of six independent XY voltage cursors. 


250 


XYCV? 


1 XY_CURSOR_VALUE? 


Returns current values of X vs Y cursors. 


1 DISPLAY— To Display Waveforms 1 


67 


ASCR 


1 AUTO_SCROLL 


Controls the Auto Scroll viewing feature. 


74 


CHST 


1 CALL_HOST 


Allows manual generation of a service request (SRQ ). 


80 


COLR 1 COLOR 


Selects color of individual objects such as traces, grids or cursors. 


83 


CSCH 


1 COLOR_SCHEME 


Selects the display color scheme. 


102 


DPNT 


1 DATA_POINTS 


Controls display of sample points in single display pixels or bold. 


216 


DISP 


1 DISPLAY 


Controls the oscilloscope display screen. 


116 


DTJN 


1 DOT_JOIN 


Controls the interpolation lines between data points. 


117 


DZOM 


1 DUAL_ZOOM 


Sets horizontal magnification and positioning for all expanded traces. 


118 1 


EKEY 


1 ENABLE_KEY 


Allows use of the KEY command in local mode. 


125 1 


FATC 


1 FAT_CURSOR 


Controls width of cursors. 


134 


FSCR 


1 FULL_SCREEN 


Selects magnified view format for the grid. 


137 


GRID 


1 GRID 


Specifies grid display in single, dual or quad mode. 


142 


HMAG 


HOR_MAGNIFY 


Florizontally expands the selected ecpansion trace. 


143 


HPOS 


HOR_POSITION 


Florizontally positions the intensified zone's center on the source trace. 


151 


INTS 


j INTENSITY 


Sets grid or trace/ text intensity level. 


154 


KEY 


1 KEY 


D isplays a string in the menu field. 


155 ! 


LOGO 


LOGO 


Displays LeCroy logo at top of grid. 


158 


MGAT 


1 MEASURE„GATE 


Controls highlighting of the region between the parameter cursors. 


160 


MSG 


{ MESSAGE 


D isplays a string of characters in the message field. 


161 


MZOM 


1 MULTI_ZOOM 


Sets horizontal magnification and positioning for all expanded traces. 


186 


PERS 


1 PERSIST 


Enables or disables the Persistence Display mode. 


187 


PECL 


1 PERSIST_COLOR 


Controls color rendering method of persistence traces. 


188 


PELT 


1 PERSIST_LAST 


Shows the last trace drawn in a persistence data map. 


189 


PESA 


1 PERSIST_SAT 


Sets the color saturation level in persistence. 


190 


PESO 


1 PERSIST_SETUP 


Selects display persistence duration in Persistence mode. 


203 


SCSV 


1 SCREEN_SAVE 


Controls the automatic screen saver. 
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204 


SEL 


SELECT 


Selects the specified trace for manual display control. 


219 


TRA 


TRACE 


E nables or disables the display of a trace. 


220 


TOPA 


1 TRACE_OPACITY 


Controls the opacity of the trace color. 


235 


VMAG 


1 VERT_MAGNIFY 


V erhcally expands the specified trace. 


236 


VPOS 


1 VERT_POSITION 


Adjusts the vertical position of the specified trace. f 


246 


XYAS? 


1 XY_ASSIGN? 


Returns the traces currently assigned to the XY display. [ 


252 


XYDS 


1 XY_DISPLAY 


Enables or disables the XY display mode. 


253 


XYRD 


XY_RENDER 


Controls X Y plot: smooth or disconnected points. 


254 


XYSA 


XY_SATURATION 


Sets persistence color saturation level in XY display. | 


! FUNCTION — To Perform Waveform Mathematical Operations 1 


1 


CLM 


CLEAR„MEMORY 


Clears the specified memory. 


76 


CLSW 


CLEAR_SWEEPS 


Restarts the cumulative processing functions. 


106 


DEF 


1 DEFINE 


Specifies the mathanatical erpression to be evaluated by a function. 


127 


FCR 


F IND_CTR_RANGE 


Automatically sets the center and width of a histogram. | 


135 


FRST 


FUNCTION_RESET 


Resets a waveform processing function. ^ 


1 HARD COPY — To Print the Contents of the Display 


1 138 


HCSU 


HARDCOPY_SETUP 


Configures the hardcopy driver. 


141 


HCTR 


HARDCOPY_TRANSMIT 


Sends a string of unmodified ASCII characters to the hardcopy unit. 


202 


SCDP 


SCREEN_DUMP 


Causes a screen dump to the hardcopy device. 


f MASS STORAGE — To Create and Delete File Directories 


112 


DELF 


DELETE_FILE 


D eletes files from the currently selected directory on mass storage. | 


113 


DIR 


DIRECTORY 


Creates and deletes file directories on mass-storage devices. J 


128 


FCRD 


1 FORMAT_CARD 


Eormats the manory card. 


130 


FFLP 


1 FORMAT_FLOPPY 


Eormats a floppy disk in the D ouble- or High-D ensity format. 


132 


FHDD 


‘ FORMAT_HDD 


Eormats the removable hard disk 


126 


FLNM 


FILENAME 


Changes the default filename of any stored trace, setup or hard copy. 


1 MISCELLANEOUS — To Calibrate and Test 


1 66 


ACAL 


AUTO_CAL I BRATE 


E nables or disables automatic calibration. 


71 


BUZZ 


1 BUZZER 


Controls the buHt-in piezoelectric buzzer. 


72 


*CAL? 


1 *CAL? 


Performs a complete internal calibration of the oscilloscope. 


73 


GOUT 


1 CAL_OUTPUT 


Sets the type of signal put out at the CAL connector. 


103 


DATE 


1 DATE 


Changes the daW time of the oscilloscope's internal real-time clock. 


145 


*IDN? 


1 *IDN? 


Used for identification purposes. 


164 


*OPT? 


1 *OPT? 


Identifies oscilloscope options. 


196 


ROUT 


1 REAR_OUTPUT 


Sets the type of signal put out at rear BN C connector. 


207 


SLEEP 


1 SLEEP 


Makes the scope wait brfore it interprets new commands 


216 1 


TDISP 


1 TDISP 


Changes time display from current to trigger or none. 


232 


*TST? 


1 *TST? 


Performs an internal self-test. 
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PROBES 


— To Use Probes 


192 


PRCA? 


PROBE_CAL? 


Perfomis a complete calibration of the connected current probe. 


193 


PRDG 


PROBE_DEGAUSS? [ 


D egausses and calibrates the connected current probe. 


194 


PRNA 


PROBE^NAME? 


G Ives an identification of the probe connected to the oscilloscope. 


SAVE/ RECALL SETUP — To PRESERVE AND Restore Eront panel &:ttings 


166 


PNSU 


PANEL_SETUP 


Complements the *SAV/ *RST commands. 


195 


*RCL 


*RCL 


Recalls one of five non- volatile panel setups. 


198 


RCPN 


RECALL_PANEL 


Recalls a front panel setup from mass storage. 


199 


*RST 


*RST 


Initiates a device reset. 


201 


*SAV 


*SAV 


Stores the current state in non-volatile internal manory. 


213 


STPN 


STORE_PANEL 


Stores the complete front panel setup on a mass- storage file. 


STATUS — To Obtain Status Ineormation and &:t Up &:rvice Requests 


63 


ALST? 


ALL_STATUS? 


Reads and clears the contents of all (but one) of the status registers. 


77 


*CLS 


*CLS 


Clears all the status data registers. 


78 


CMR? 


CMR? 


Reads and clears the contents of the CoMmand error Regista' (CMR). 


104 


DDR? 


DDR? 


Reads and clears the D evice-D ependent error Register (DDR). 


119 


*ESE 


*ESE 


Sets the standard Event Status Enable (ESE) register. 


120 


*ESR? 


*ESR? 


Reads and clears the Evait Status Register (ESR). j 


123 


EXR? 


EXR? 


Reads and clears the Execution error Register (EXR). 1 


146 


INE 


INE 


Sets the INtemal state change Enable register (INE). 


147 


INR? 


INR? 


Reads and clears the INtemal state change Register (INR). | 


153 


1ST? 


1ST? 


Individual STatus reads the current state of IEEE 488. 


163 


*OPC 


*OPC 


Sets to tme the 0 PC bit (0) in the Event Status Register (ESR). 


191 


*PRE 


*PRE 


Sets the PaRallel poll Enable register (PRE). 


208 


*SRE 


*SRE 


Sets the Service Request Enable register (SRE). 


209 


*STB? 


*STB? 1 


Reads the contents of IEEE 488. 


233 


URR? 


URR? 


Reads and clears the User Request status Regista' (URR). 


238 


*WAI 


*WAI 


WAR to continue — required by IEEE 488. 


WAVEEORM TRAN SEER — To PRESERVE AND Restore Waveeorms 1 


149 1 


INSP? 


INSPECT? 


Allows acquired waveform parts to be read. 


197 


REG 1 


RECALL 


Recalls a waveform file from mass storage to internal memories Ml- 4. 


212 


STO 


STORE 


Stores a trace in one of the internal memories Ml- 4 or mass storage. 


214 


STST 1 


STORE_SETUP 


Controls the way in which traces are stored. 


215 


STTM 


STORE_TEMPLATE 


Stores the waveform tanplate in a mass-storage device. 


217 


TMPL? 1 


TEMPLATE? 


Produces a copy of the tanplate describing a complete waveform. 


240 

J 


WF 


WAVEFORM 


T ransfers a waveform from the controller to the oscilloscope. 


243 


WFSU 


WAVEFORM_SETUP 


Spaifies amount of waveform data for transmission to controller. 


[ 245 


WFTX 


WAVEFORM_TEXT 


D ocuments the conditions imder which a waveform has been acquired 

— - - - 
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STATUS 

DESCRIPTION 

QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 
RELATED COMMANDS 



ALL_STATUS?, ALST? 

Query 



The ALL_STATUS ? queiy reads and clears the contents of all status 
registers: STB, ESR, INR, DDR, CMR, EX R and URR except for the 
MAY bit (bit 6) of the STB register. Eor an interpretation of the 
contents of each register, refer to the appropriate status register. 

The query is useful in a complete overview of the state of your 
Wavenmner oscilloscope. 



ALl_STatus? 



ALi_STatus STB, <value>, ESR, <value>, inr, <value>, 
DDR, <value>, CMR, <value>, exr, <value>, urr, <value> 



<value> : = 0 to 65535 



The following reads the contents of aU the status registers: 

CMD$="ALST?" : CALL IBWRT ( SCOPE% , CMD$ ) : 

CALL IBRD (SCOPE%, RSP$) : PRINT RSP$ 

Response message: 

ALST 

TB, 000000, ESR, 000052, INR, 000005, DDR, 000000, 
CMR, 000004, EXR, 000024, URR, 000000 

*CLS, CMR?, DDR?, *ESR?, EXR?, *STB?, URR? 
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ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE 

RELATED COMMANDS 



ARM_ACQUISITION, ARM 

Command 



The ARM_AC QU I s I T I ON command enables the signal acquisition 
process by changing the acquisition state (trigger mode) from 
"stopped" to "sin^e". 

ARM_acquisition 

The following enables signal acquisition: 

CMD$="ARM": CALL IBWRT ( SCOPE% , CMD$ ) 

STOP, *TRG, TRIG_MODE, WAIT 
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ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 

AVAILABILITY 

EXAMPLE (GPIB) 



ATTENUATION, ATTN 

Command/ Query 



The ATTENUATION command selects the vertical attenuation factor of 
the probe. Values of 1, 2, 5, 10, 20, 25, 50, 100, 200, 500, 1000 or 10000 
can be specified. 

XheATTENUATiON? query retums the attenuation factor of the 
specified channel. 



<channel> : ATTeNuation <attenuation> 

<channel> : = {ci, C2, C3, C4, ex, EXio} 

<attenuation> : = {l, 2, 5, lO, 20, 25, 50, lOO, 200, 500, 
1000 , 10000 } 



<channel> : ATTeNuation? 



<channel> : ATTeNuation <attenuation> 

<channel> : {C3, C4} available only on four-channel Waverunner 
oscilloscopes. 

The following sets to 100 the attenuation factor of Channel 1: 

CMD$="C1 :ATTN 100": CALL IBWRT (SCOPE%, CMD$ ) 
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MISCELLANEOUS 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



AUTO_CALIBRATE, ACAL 

Command/ Query 



The AUTO_CALiBRATE command is used to enable or disable the 
automatic calibration of your Waverunner oscilloscope. At power-up, 
auto-calibration is turned ON, i.e. all input channels are periodically 
calibrated for the current input amplifier and timebase settings. 

The automatic calibration can be disabled by issuing the command 
ACAL OFF. Whenever convenient, a *cal? query m^ be issued to 
fully calibrate the oscilloscope. When the oscilloscope is returned to 
loci control, the periodic calibrations are resumed. 

The response to the auto_cal i brate ? query indicates whether 
auto-cahbration is enabled. 



Auto_CALibrate <State> 

<state> : = {on, off} 

Auto_CALibrate? 

Auto_CALibrate <State> 

The following disables auto-calibration: 

CMD$="ACAL OFF": CALL IBWRT ( SCOPE% , CMOS ) 



*CAL? 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



AUTO_SCROLL, ASCR 

Command/ Query 



The AUTO_scROLL command and query controls the Auto Scroll 
feature, accessed throu^ the front panel using the MATH SETUP 
button and ZO 0 M + MATH menus. This automatically moves the 
selected trace (or all traces if multi-zoom is on) across the screen. The 
command turns the scroll on and off and sets the scrolling speed in 
divisions per second, and the query returns the current scroll rate. 



Auto_scRoii <action>,<mode>,<^eed> 
<action> : = {play, reverse, stop} 
<mode> : = {div_s, div_u} 

<speed> : = 0.01 to 10.00 for DIV U mode; 

0.10 to 10.00 for D IV S mode. 



Auto_SCRoll? 



Auto_scRoii <action>,<mode>,<^eed> 

The following activates Auto Scroll and start scrolling the data to the 
right at a rate of 2 s/ div.: 

CMD$="ASCR PLAY, DIV_S, 2" : CALL IBWRT ( SCOPE% , CMD$ ) 



MULTI_ZOOM, H0R_MAGNIFY, H0R_P0SITI0N 
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ACQUISITION 

DESCRIPTION 



COMMAND SYNTAX 

AVAILABILITY 

EXAMPLE 



AUTO_SETUP, ASET 

Command 



The AUTO_SETUP command attempts to display the input signal(s) by 
adjusting the vertical, timebase and trigger parameters, auto-setup 
operates only on the channels whose traces are currently turned on. If no 
traces are turned on, auto_setup operates on all channels and turns 
on all of the traces. 

If signals are detected on several channels, the lowest numbered 
channel with a signal determines the selection of the timebase and 
trigger source. 

If only one input channel is turned on, the timebase will be adjusted 
for that channel. 

The <channel> : auto_setup find command adjusts gain and 
offset only for the specified channel. 



<channel> : Auto_SETup [find] 

<channel> : = {ci, C2, C3, C4} 

If the FIND keyword is present, gain and offset adjustments will be 
performed only on the specified channel. In this case, if no <channel> 
prefix is added, then an auto-setup will be performed on the channel 
used on the last aset f ind remote command. In the absence of the 
FIND keyword, the normal auto-setup will be performed, regardless of 
the <channel> prefix. 

<channel> : = {C3, C4} only on four-channel Waverunner 
oscilloscopes. 



The following instructs the oscilloscope to perform an auto-setup: 

CMD$="ASET": CALL IBWRT ( SCOPE% , CMD$ ) 
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ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 

AVAILABILITY 

EXAMPLE 



BANDWIDTH_LIMIT, BWL 

Command/ Query 



BANDWiDTH_LiMiT enables or disables the bandwidth-limiting low- 
pass filter. When Global BWL (see page 136) is on, the BWL command 
applies to aU channels; when off, the command is used to set the 
bandwidth individually for each channel. The response to the 
BAND w I D T H_L I M I T ? gueiy indicates whether the bandwidth filters 
are on or off. 



BandWidth_Limit <mode> 

Or, alternatively, to choose the bandwidth limit of an individual 
channel or channels when Global BWL is off: 

Bandwidth_Limit <channd>, <mode>[, <channel>, <mode> 

[, <channel>, <mode>[, <channel>, <mode>]]] 

<mode> : = {off, ON, 200MHZ} 

<channel> : = {ci, C2, C3, 04} 



BandWidth_Limit ? 

When Global BWL is on, or if Global BWL is off and all four channels 
have the same bandwidth limit, the re^onse is: 

BandWidth_Limit <mode> 

Or, alternatively, if at least two channels have their bandwidth limit 
filters set differently from one another, the response is: 

Bandwidth_Limit <channd>, <mode>[, <charmd>, <mode> 

[, <channel>, <mode>[, <channel>, <mode>]]] 

{C3, C4} : Available only on four-channel models. 



The following turns on the bandwidth filter for all channels, when 
G lobal BWL is on (as it is by default): 

CMD$="BWL ON": CALL IBWRT ( SCOPE% , CMD$ ) 
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RELATED COMMANDS 



The following turns the bandwidth filter on for Channel 1 only (the first 
turns off Global BWL): 

CMD$="GBWL OFF": CALL IBWRT ( SCOPE% , CMD$ ) 
CMD$="BWL Cl, ON": CALL IBWRT ( SCOPE% , CMD$ ) 
CMD$="GBWL OFF": CALL IBWRT ( SCOPE% , CMD$ ) 
CMD$="BWL Cl, ON": CALL IBWRT ( SCOPE% , CMD$ ) 

GLOBAL_BWL 
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MISCELLANEOUS 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 



BUZZER, BUZZ 

Command 



The BUZZER command controls the built-in piezo-electric buzzer. 
This is useful for attracting the attention of a local operator in an 
interactive working application. The buzzer can either be activated for 
short beeps (about 400 ms long in BEEP mode) or continuously for a 
certain time interval you select by turning the buzzer 0 N or 0 EE. 



NOTE: This command is oniyabie to be used in osciiioscapes 
Btted with the CLBZ hard option [T 






BUZZer <state> 

<state> : = {beep, on, off} 



Sending the following will cause the oscilloscope to sound two short 
tones. 

CMD$="BUZZ BEEP; BUZZ BEEP"; 

CALL IBWRT (SCOPE%, CMD$) 
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MISCELLANEOUS 

DESCRIPTION 

QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*CAL? 

Query 



The * CAL ? query causes the oscilloscope to perform an internal self- 
calibration and generates a response that indicates whether or not your 
Waverunner oscilloscope completed the calibration without error. This 
internal calibration sequence is the same as that which occurs at power- 
up. At the end of the calibration, after the re^onse has indicated how 
the calibration terminated, the oscilloscope returns to the state it was in 
just prior to the calibration cycle. 



*CAL? 



*CAL <diagnostics> 

<diagnostics> : = 0 or other 
0 = Calibration successful 

The following forces a self-calibration: 

CMD$="*CAL?" : CALL IBWRT ( SCOPE% , CMD$ ) : 
CALL IBRD (SCOPE%, RD$) : PRINT RD$ 

Response message (if no failure): *cal o 



AUTO_CALIBRATE 
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MISCELLANEOUS 



CAL_OUTPUT, COUT 

Command/ Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 



The CAL_0UTPUT command is used to set the type of signal put out at 
the Wavenmner front panel CAL connector. 

Cai_0UTput <mode>[, <level>[, <rate>]] 

<mode> : = {CALSQ, level} 

<level> : = -1.0 to 1.00 V into 1 MO 
<rate> : = 500 Hz to 1 MHz. 



Cal_OUTput? 

Cai_0UTput <mode>,<level>[,<rate>] 

The following sets the calibration signal to give a 0- 0.2 volt pulse of 
25 ns width at a 10 kHz rate: 

CMD$="COUT PULSE, 0.2 V, 10 kHz"; 

CALL IBWRT (SCOPE%, CMD$) 



ADDITIONAL INEORMATION 



1 “ — 


Notation * 


CALSQ 


Provides a square signal 


LEVEL 


Provides a D C signal at the requested level 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



CALL_HOST, CHST 

Command/ Query 



The CALL_HOST command allows you to manually generate a service 
request(SRQ). OncetheCALL HOST command has been received, 
the message "CaU Host" wiU be displayed next to the lowest button on 
the menu-button column immediately next to the screen. Pressing this 
button while in the root menu sets the User Request status Register 
(URR) and the URQ bit of the Event Status Register. This can generate 
a SRQ in local mode, provided the service request mechanism has been 
enabled. 

The response to theCALL_HOST? query indicates whether CALL 
HO ST is enabled (on) or disabled (off). 



Call_HoST <state> 

<state> : = {on, off} 



Call_HoST? 



Caii_HoST <state> 



After executing the following an SRQ request wiU be generated 
whenever the button is pressed (it is assumed that SRQ servicing has 
already been enabled): 

CMD$="CHST ON": CALL IBWRT ( SCOPE% , CMD$ ) 



URR 
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FUNCTION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 
RELATED COMMANDS 



CLEAR_MEMORY, CLM 

Command 



The CLEAR_MEMORY command cleans the specified memory. Data 
previously stored in this memory are erased and memory space is 
returned to the free memory pool. 

CLear_Memory < memory> 

<memory> : = {mi, m2, m3, m4} 

The following clears the memory M2. 

CMD$="CLM M2": CALL IBWRT ( SCOPE% , CMD$ ) 

STORE 
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FUNCTION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



CLEAR_SWEEP S , CLSW 

Command 



The CLEAR_swEEP s command restarts the cumulative processing 
functions: summed or continuous average, extrema, FFT power 
average, histogram, pulse parameter statistics. Pass/ Fail counters, and 
persistence. 



CLear SWeeps 

The following example will restart the cumulative processing: 

CMDS="CLSW": CALL IBWRT ( SCOPE% , CMD$ ) 



DEFINE, INR 
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STATUS 

DESCRIPTION 
COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



*CLS 

Command 

The *CLS command cleans all status data registens. 

*CLS 

The following causes all the status data registens to be cleared: 

CMD$="*CLS": CALL IBWRT ( SCOPE% , CMD$ ) 
ALL_STATUS, CMR, DDR, *ESR, EXR, *STB, URR 



LTXXX-RCM-E Rev B 



I SSUE D : January 2002 



77 




Part Two: COMMANDS 



STATUS 

DESCRIPTION 

QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 
RELATED COMMANDS 



CMR? 

Query 



The CMR? query ruads and clears the contents of the CoMmand error 
Register (CMR) — see table next page — which ^edfies the last syntax 
error type detected by your Waverunner oscilloscope. 



CMR? 



CMR <value> 

<value> : = 0 to 13 

The following reads the contents of the CMR register: 

CMD$="CMR?": CALL IBWRT ( SCOPE% , CMD$ ) : 
CALL IBRD (SCOPE%, RSP$) : PRINT RSP$ 



ALL_STATUS?, *CLS 
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ADDITIONAL INFORMATION 





Command Error Status Register Structure (CMR) 


Value 


Description 


1 


Unrecognized command/ query header 


2 


Illegal header path 




Illegal number 


4 


Illegal number suffix 


5 


Unrecognized keyword 


6 


String error 


7 


G ET embedded in another message 


10 

- 


Arbitrary data block expected 


11 


Non-digit character in byte coimt field of arbitrary data block 


12 


EOI detected during definite length data block transfer 


13 


Extra bytes detected during definite length data block transfer 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 

RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



COLOR, COLR 

Command/ Query 



The COLOR command is used to select the color of an individual 
display object such as text, trace, grid or cursor. 

The response to the CO LO R? query indicates the color assigned to 
each display object, whether or not it is cirrrently di^layed. 



NOTE; This command is oniy effective if the coior scheme 
(CSCH) is chosen horn the userschmKS Ui, UZ U3or U4. 



coLoR <object, color>[,...<object>,<color>] 




<object> : = {BACKGND, Cl, C2, C3, C4, TA, TB, TC, TD, GRID, 
TEXT, CURSOR, NEUTRAL, WARNING }, 

<COlor> : = { WHITE, CYAN, YELLOW, GREEN, MAGENTA, 
BLUE, RED, LTGRAY, GRAY, SLGRAY, CHGRAY, DKCYAN, 
CREAM, SAND, AMBER, OLIVE, LTGEEN, JADE, LMGREEN, 
APGREEN, EMGREEN, GRGREEN, OCSPRAY, ICEBLUE, 
PASTBLUE, PALEBLUE, SKYBLUE, ROYLBLUE, DEEPBLUE, 
NAVY, PLUM, PURPLE, AMETHYST, FUCHSIA, RASPBRY, 
NEONPINK, PALEPINK, PINK, VERMIL, ORANGE, CERISE, 
KHAKI, BROWN, BLACK} 



COLOR? 



coLoR <object>, <color>[, ...<object>, <color>] 



The following selects color scheme U 1, and then red as the color of 
Channel 1: 

CMD$="CSCH Ul": CALL IBWRT ( SCOPE% , CMD$ ) 
CMD$="COLR Cl, RED": CALL IBWRT ( SCOPE% , CMD$ ) 



COLOR_SCHEME, PERS I ST_COLOR 
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ADDITIONAL INFORMATION 



Notation 


<coloi> 


Color 


<coloi> 


Color 


, WHITE 


White 


OCSPRAY 


Ocean Spray 


CYAN 


Cyan 


ICEBLUE 


Ice Blue 


YELLOW 


Yellow 


PASTBLUE 


Pastel Blue 


GREEN 


Green 


PALEBLUE 


Pale Blue 


MAGENTA 


Magenta 


SKYBLUE 


Sky Blue 


BLUE 


Blue 


ROYLBLUE 


Royal Blue 


RED 


Red 


DEEPBLUE 


Deep Blue 


LTGRAY 


Light Gray 


NAVY 


Navy 


GRAY 


Gray 


PLUM 


Plum 


1 SLGRAY 


Slate Gray 


PURPLE 


Purple 


CHGRAY 


Charcoal Gi^ 


AMETHYST 


Amethyst 


DKCYAN 


Dark Cyan 


FUCHSIA 


Fuchsia 


CREAM 


Cream 


RASPB 


Raspberry 


SAND 


Sand 


NEONPINK 


Neon Pink 


AMBER 


Amber 


PALEPINK 


Pale Pink 


OLIVE 


Olive 


PINK 


Pink 


LTGREEN 


Li^t Green 


VERMIL 


Vermilion 


JADE 


Jade 


ORANGE 


Orange 


LMGREEN 


Lime Green 


CERISE 


Cerise 


APGREEN 


Apple Green 


KHAKI 


Khaki 
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1 EMGREEN 


Emerald Green 


BROWN 


Brown 


GRGREEN 


GrassGreen 


BLACK 


Black 


<object> 


Display Object 


<object> 


Display Object 


BACKGND 


Background 


CURSOR 


cursors 


Cl . .C4 


Channel Traces 


WARNING 


Warning Messages 


TA. .TD 


Function Traces 


NEUTRAL 


Neutral color 


GRID 


Gridlines 


OVERLAYS 


Menu background color 
in FULL SCREEN 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



COLOR_SCHEME, CSCH 

Command/ Query 



The C0L0R_SCHEME command is used to select the color scheme for 
the display. 

The response to the color_scheme ? query indicates the color 
scheme in use. 



Coior_scHeme <scheme> 

<scheme > : = {l, 2, 3, 4, 5, 6, l, Ul, U2, U3, U4} 



Color_SCHeme? 



Coior_scHeme <scheme> 

The following selects the user color scheme U2: 

CMD$="CSCH U2": CALL IBWRT ( SCOPE% , CMD$ ) 



COLOR, PERSIST_COLOR 
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COMMUNICATION 

DESCRIPTION 

COMMAND SYNTAX 



QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

ADDITIONAL INEORMATION 

DEF9: 



COMM_FORMAT, CFMT 

Command/ Query 



The C0MM_F0RMAT command selects the format the oscilloscope uses 
to send waveform data The available options allow the block format, the 
data type and the encoding mode to be modified from the default 
settings. 

The C0MM_F0RMAT ? gueiy returns the currently selected waveform 
data format. 



c omm_F o r Ma T <block_foimat> , <data_type> , <encoding> 
<block_format> : = {def9, indo, off} 

<data_type> : = {byte, word} 

<encoding> : = {bin, hex} 

(G PIB uses both encoding forms, RS-232-C alw^s uses HEX) 

Initial settings (ie. after power-on) are: 

EorGPIB: DEF9, WORD, BIN 
For RS-232-C: DEF 9, WORD, HEX 



Comm_ForMaT? 



c omm_F o r Ma T <block_format>,<data_type>,<encoding> 



The following redefines the transmission format of waveform data The 
data will be transmitted as a block of indefinite length. D ata will be 
coded in binary and represented as 8-bit integers. 

CMD$="CFMT INDO, BYTE, BIN" : CALL IBWRT (SCOPE%, CMD$ ) 



Block Eoimat 

Uses the IEEE 488.2 definite length arbitrary block response data 
format. The digit 9 indicates that the byte count consists of 9 digits. 
The data block directly follows the byte count field. 

For example, a data block consisting of three data bytes would be sent 
as: 
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INDO: 



OFF: 



BYTE: 

WORD: 



BIN: 

HEX: 



WF DATl, #9000000003<DAB><DABxDAB> 

where <DAB> represents an ei^t-bit binary data byte. 

Uses the IEEE 488.2 indefinite length arbitrary block response data 
format. 

A <NL^ND > (new line with EO I) signifies that block transmission 
has ended. 

The same data bytes as above would be sent as: 

WF DATl, #0<DAB><DABxDAB><NL^ND> 

Same as INDO. In addition, the data block type identifier and the 
leading #0 of the indefinite length block will be suppressed. The data 
presented above would be sent as: 

WF <DABxDABxDABxNL^ND> 




Transmits the waveform data as ei^t-bit signed integers (one byte). 



Transmits the waveform data as 16-bit signed integers (two bytes). 




Binary encoding (G PIB only) 

Hexadecimal encoding (bytes are converted to 2 hexadecimal ASCII 
digits (0, ...9, A, ...E)) 



RELATED COMMANDS WAVEFORM 
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COMMUNICATION 



COMM_HEADER, CHDR 

Command/ Query 



DESCRIPTION The comm_header command controls the way the oscilloscope 

formats responses to queries. There are three response formats: 
LO NG , in which responses start with the long form of the header 
word; SHO RT, where re^onses start with the short form of the 
header word; and 0 FF, for which headers are omitted from the 
response and suffix units in numbers are suppressed. 



Unless you request otherwise, the SHO RT re^onse format is used. 



NOTE: The default fonmt, Le 
thatjust alter power-on, is SHt 


1 

IRT 


This command does not affect the interpretation of messages sent 
to the oscilloscope. Headers can be sent in their long or short 
form regardless of the comm_header setting. 

Querying the vertical sensitivity of Channel 1 may result in one of 
the following responses: 

7 




( 




COMM_HEADER 


Response 




LONG 


Cl:VOLT_DIV 200E-3 V 


SHORT 


C1:VDIV 200E-3 V 


OFF 


200E-3 



COMMAND SYNTAX Comm_HeaDeR <mode> 

<mode> : = {short, long, off} 



QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 



RELATED COMMANDS 



C omm_H e a D e R ? 



Comm_HeaDeR <mode> 

The following code sets the re^onse header format to SHO RT : 

CMD$="CHDR SHORT"; CALL IBWRT ( SCOPE% , CMD$ ) 
COMM_HELP_LOG 
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COMMUNICATION 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



COMM_HELP , CHLP 

Command/ Query 



The C0MM_HELP command controls the level of operation of the 
diagnostics utility Remote Control Assistant (see the Waverunner 
Operator's Manual), which assists in debugging remote control 
programs. Selected using your Waverunner oscilloscope's front panel 
(see the Operator's Manual), Remote Control Assistant can log all 
message transactions occurring between the external controller and the 
oscilloscope. You can view the log at any time on-screen and can 
choose from four levels: 



OFF 


Don't assist at all. 


EO 


Log detected Errors Only (default after power-on). 


FD 


Log the EuU Dialog between the controller and the 
oscilloscope. 


R 

S 


Log the EuU Dialog and send it to a recording device 
connected to the RS232 port. 



Comm_HeLP <level> 

<level> : = { OFF, EO, FD, RS, } 

The default level (i.e. the level just after power-on) is EO. 



Comm_HeLP? 



Comm_HeLP <level> 

After sending this command, all the following commands and re^onses 
will be logged: 

CMD$="CHLP FD": CALL IBWRT ( SCOPE% , CMD$ ) 



COMM_HELP_LOG 
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COMMUNICATION 

DESCRIPTION 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



COMM_HELP_LOG? , CHL? 

Query 



The C0MM_HELP_L0G queiy returns the current contents of the log 
geneiuted by the Remote Control Assistant (see chlp description). If 
the optional parameter clr is verified, the log will be cleared after the 
transmission. Otherwise, it will be kept. 



Comm_HeLP_Log? [CLR] 



c omm_H e 1 p_L o g <string containing the logged text> 



The following reads the remote control log and prints it: 

CMD$="CHL?": CALL IBWRT ( SCOPE% , CMD$ ) PRINT 



COMM_HELP 
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COMMUNICATION 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE 



COMM_ORDER, CORD 

Command/ Query 



The C0MM_0RDER command controls the byte order of waveform 
data transfers. Waveform data can be sent widr the most significant byte 
(MSB) or the least significant byte (LSB) in the first position. The 
default mode is to send the MSB first. comm_order applies equally to 
the waveform's descriptor and time blocks. In the descriptor some 
values are 16 bits long ("word"), 32 bits long ("long" or "float"), or 64 
bits long ("double"). In the time block all values are floating values, i.e. 
32 bits long. When comm_order hi is ^ecified, the MSB is sent 
first; when comm_order lo is specified, the LSB is sent first. 

The comm_order? query returns the byte transmission order in 
current use. 



Comm_ORDer <mode> 
<mode> : = {hi, lo} 




NOTE; The initial mode, i.e. the mode aiterpower-on, is HI. 


— 


Comm_ORDer ? 


7 



Comm_ORDer <mode> 



The order of transmission of waveform data depends on the data type. 
The following table illustrates the different pos^hities: 
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Part Two: COMMANDS 



Type 


CORD HI 


CORD LO 


Word 


<MSBxLSB> 


<LSBxMSB> 


LongorEloat 


< MSB ><byte2 xbyteS ><L SB > 


<L SB > <byte3> <byte2 xMSB > 


Double 


<MSBxbyte2>...<byte7xLSB> 


<LSBxbyte7>...<byte2xMSB> 



RELATED COMMANDS WAVEFORM 
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Remote Conbol Commands and Quaies 



COMMUNICATION 

DESCRIPTION 

PARAMETERS 

End Input character: 

End Output string: 

Line Length: 

Line Separator: 

SRQ string: 

LTXXX-RCM-E Rev B 



COMM_RS232, CORS 

Command/ Query 



The C 0 MM_RS 2 32 command sets the parameters of the RS-232-C 
port for remote control. 

The C0MM_RS 2 32? gueiy reports the settings of the parameters. 



NOTE: This command and query is only valid when you control 
the oscilloscope rerrmtely using Ae HhverunnerRS-232-C port 




When received by the oscilloscope, this character is interpreted as the 
END-of-a-command message marker. The commands received will 
be parsed and executed. 

The oscilloscope adds this string at the end of a response message. 
When the host computer receives this string, it knows that the 
oscilloscope has completed its response. 

This parameter defines the maximum number of characters sent to the 
host in a sin^e line. Remaining characters of the re^onse are output 
in separate additional lines. This parameter is only applicable if a line 
separator has been selected. 

This parameter is used to select the line-splitting mechanism and to 
define the characters used to split the oscilloscope response messages 
into many lines. Possible line separators are: OR, LE, CRLE. <CR>, 
<LE> or <CR> followed by <LE>. These are sent to the host 
computer after <line_length> characters. 

This string is sent each time the oscilloscope signals an SRQ to the 
host computer. 

Some CQMM_RS232 parameters reguire ASCII strings as actual 
arguments. In order to facilitate the embedding of non-printable characters 
into such strings, esc^e seguences can be itsed. The back-slash character 
(\ ') is Itsed as an esc^e character. The following esc^e seguences ate 
recognized: 
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"\a" : 


Bell character 


"\b" : 


Back space character 


"\e" : 


Escape character 


"\n" : 


Line feed character 


"\r" : 


Carriage return character 


"\t" : 


Horizontal tab character 


"W": 


The back-slash character itself 


"\ddci" : 


Represents one to three decimal digit characters giving 



the code value of the corresponding ASCII character. 
This allows any ASCII code in the range 1 to 127 to be 
inserted. 



Before using the string, the oscilloscope will replace the escape 
seguence by the corresponding ASCII character. 

For example, the escape seguences "\ r", "\ 13" and "\ 013" are all 
replaced by the single ASCII character <Carriage Retum>. 



1 Notation I 


1 


End input character 


EO 


End output string 


LL 


Line length 


LS 


Line separator 


SRQ 


SRQ service request 
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COMMAND SYNTAX 



QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE 



comm_RS232 El, <d_chai>, EO, '<eo_string>' , ll, <line_length>, ls, 
<Line_sep>,SRQ, '<siq_string>' 

<ei_char> : = 1 to 126 (default: 13 = Carriage Return) 

<eo sttinq> : = A non-empty ASCII string of up to 20 characters 
(default: "\ n\ r") 

<line_length> : = 40 to 1024 (default: 256) 

<line_sep> : = {off, cr, lf, crlf} (default: OFF) 

<srq_string> : = An ASCII string of up to 20 characters which 
be empty (default: empty string) 

COmm_RS232? 



comm_RS232 El , <d_char>, EO, "p <eo_stiing>" , LL, <line_length>, 
LS, <line_sep>, srq, "<sig_string>" 



After executing the command 

COMM_RS232 EI,3,EO, "\r\nEND\r\n" 

the oscilloscope will assume that it has received a complete message 
each time the <ETX > (decimal value 3) is detected. Re^onse 
messages will be terminated by sending the character secjuence 
"<CRxLF>END <CRxLE>". 
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Part Two: COMMANDS 



ACQUISITION 

DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
RESPONSE EORMAT 



AVAILABILITY 



EXAMPLE (GPIB) 



COUPLING, CPL 

Command/ Query 

The COUPLING command selects the coupling mode of the 
specified input channel. 

The CO UPLING ? query returns the coupling mode of the specified 
channel. 

<channel> : CouPLing <coupling> 

<channel> : = {ci, C2, C3, C4, ex, exio} 

<coupling> : = {aim, dim, d5 0, gnd} 

<channel> : CouPLing? 

<channel> : CouPLing <coupling> 

<coupling> : = {aim, dim, d50, gnd, ovl} 

<coupling> : OVL is retirmed in the event of signal overload while in 
DC 50 coupling. In this condition, the oscilloscope will disconnect 
the input. 



<channel> : = {C3, C4} only on four-channel Waverunner 
oscilloscopes. 

The following sets the coupling of Channel 2 to 50 D C: 

CMD$="C2:CPL D50": CALL IBWRT (SCOPE%, CMD$ ) 
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RemotB Conbol Commands and Quaies 



CURSOR 

DESCRIPTION 



COMMAND SYNTAX 



CURSOR_MEASURE, CRMS 

Command/ Query 



The CURS0R_MEASURE command ^ecifies the type of cursor or 
parameter measurement to be displayed, and is the main command for 
displaying parameters and Pass/ Fail. 

The CURS0R_MEASURE ? query indicates which cursors or 
parameter measurements are currently displayed. 



1 Notation 


abs 


absolute reading of relative cursors | 


OUST 


custom parameters 


FAIL 


Pass/ Fail: fail | 


HABS 


horizontal absolute cursors 


HPAR 


standard time parameters 


HREL 


horizontal relative cursors 


OFF 


cursors and parameters off 


PARAM 


synonym for VPAR 


PASS 


Pass/ Fail: pass 


SHOW 


custom parameters (old form) 


STAT 


parameter statistics 1 


VABS 


vertical absolute cursors | 


VPAR 


standard voltage parameters 


VREL 


vertical relative cursors 



NOTE; The PARAM mode is turned OFF wiien XY mode is C 


m. 




7 



CuRsor_MeaSure <mode>[,<submode>] 

<mode> : = {cost, fail, habs, hpar, hrel, off, param, 

PASS, SHOW, VABS, VPAR, VREL} 

<submode> : = {stat, abs} 



LTXXX-RCM-E Rev B 



I SSUE D : January 2002 



95 






QUERY SYNTAX CuRsor_MeaSure? 



RESPONSE EORMAT CuRsor_MeaSure <mode> 

EXAMPLE (GPIB) The following switches on the vertical relative cursors: 

CMD$="CRMS VREL": CALL IBWRT ( SCOPE% , CMD$ ) 

The following determines which cursor is currently turned on: 

CMDS$="CRMS?" : CALL IBWRT ( SCOPE% , CMD$ ) : 

CALL IBRD (SCOPE%, RD$) : PRINT RD$ 

Example of response message: 

CRMS OFF 

RELATED COMMANDS CURS0R_SET, parameter_statistics, 

PARAMETER_VALUE, PASS_FAIL_CLEAR, 

PAS S_FAI L_COND I T I ON , PAS S_FAI L_DELETE , 
PASS_FAIL_MASK, 

ADDITIONAL INEORMATION To turn off the cursors, parameter measurements or Pass/ Fail tests, 

use: 

CURSOR_MEASURE OFF 

To turn on a cursor displ^, use one of these four forms: 

CURSOR_MEASURE HABS 
CURSOR_MEASURE HREL 
CURSOR_MEASURE VABS 
CURSOR_MEASURE VREL 
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RentotB Conbol Commands and Quaies 



To turn on a cursor use one of these four forms: 

CURSOR_MEASURE HABS 

CURSOR_MEASURE HREL 
CURSOR_MEASURE VABS 
CURSOR_MEASURE VREL 
CURSOR_MEASURE FAIL 

To select parameters in the Custom mode, and to modify the test 
conditions in the Pass/ Fail mode, use the command: 

PAS S_FAI L_COND I T I ON 
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CURSOR CURSOR_SET, CRST 

Command/ Query 

DE SCRIPTION The CURSO R_ SET command allows you to position any one of the 

eight independent cursors at a given screen location. The positions 
of the cursors can be modified or queried even if the required cursor 
is not currently displayed on the screen. 

When setting a cursor position, a trace must be ^edfied, relative to 
which the cursor will be positioned. 

NOTE; If the paiaimtier display is turned on (or the Pass/ Fail 
display or the extended parameters displ^), the parameters of 
the speciSed trace wiU be shown unless the newly chosen trace 
is not displayed or has hem acquired in sequence rrwde; these 
conditions will produce an emimnment error (see table on 
page 12h. To charge only the trace without r^xmtioning the 
cursors, the CURS0R_SET command can be given with no 
argument (for example, TB:CRST). 

The CURSO R_ SET? query indicates the current position of — 

the cursorfs). The values returned depend on the grid type selected. 



r “ “ 


Notation 




habs 


horizontal absolute 


PREF 


parameter reference 


HDIF 


horizontal difference 


VABS 


vertical absolute 


HREF 


horizontal reference 


VDIF 


vertical difference i 


PDIF 


parameter difference 


VREF 


1 

vertical reference | 



COMMAND SYNTAX <trace> : CuRsor_SeT <cursor>, <position>[, <cursor>, <position>, 

<cursoi> , <position>] 

<trace> : = {ta, tb, tc, td, ci, C2, C3,C4} 

<cursor> : = {habs, vabs, href, hdif, vref, vdif, 

PREF, PDIF} 

<position> : = 0 to 10 DIV (horizontal) 
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QUERY SYNTAX <trace> : CuRsor_SeT? [<cursor>,...<cursor>] 



<cursor> : = {habs, vabs, href, hdif, vref, vdif, 

FREE, PDIF, all} 



RESPONSE EORMAT <tiace> : CuRsor_SeT 

<cursoi>, <position>[, <cursoi>, <position>, ...<cursor>, <position>] 



If <cursor> is not specified, ALL will be assumed. If the position of 
a cursor cannot be determined in a particular situation, its position 
will be indicated as UNDER 

AVAILABILITY <trace> : {C3, C4} available only on four-channel oscilloscopes. 

EXAMPLE (GPIB) The following positions the VREF andVDIE cursorsat -iSDIV and 

-7 DIV respectively, using Trace A as a reference: 

CMD$="TA:CRST VREF, 3DIV, VDIF, -7DIV" : 

CALL IBWRT (SCOPE%, CMD$) 



RELATED COMMANDS CURSOR_MEASURE, CURSOR VALUE, 

PARAMETER_VALUE, PER_CURSOR_SET , 
XY_CURSOR_SET 
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Part Two: COMMANDS 



CURSOR 

DESCRIPTION 



QUERY SYNTAX 
RESPONSE EORMAT 



AVAILABILITY 



CURSOR_VALUE?, CRVA? 

Query 

The CURS0R_VALUE ? query returns the values measured by the 
specified cursors for a given trace. (The parameter_value ? query 
is used to obtain measured waveform parameter values.) 



Notation 

HABS horizontal absolute 

HREL horizontal relative 



<trace> : CuRsor_VAiue? [<mode>, ...<mode>] 

<trace> : = {ta, tb, tc, td, ci, C2, C3,C4} 
<mode> : = {habs, hrel, vabs, vrel, all} 



<trace> : CuRsor_VAiue HABS, <abs_hori>, <abs_vert> 
<trace> : CuRsor_VAiue HREL, <delta_hori> , <delta_vert>, 
<absvert_ref>, <absvert_dif> 

<trace> : c u r s o r_VA 1 u e VABS, <abs_ vert> 

<trace> : CuRsor_VAiue VREL, <delta_vert> 



For horizontal cursors, both horizontal as well as vertical values are 
given. For vertical cursors only vertical values are given. 




I F 

<trace> : = {C3, C4} available only on four-channel oscilloscopes. 
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EXAMPLE (GPIB) 



RELATED COMMANDS 



The following query reads the measured absolute horizontal value of 
the cross-hair cursor (HABS) on Channel 2: 

CMD$="C2 :CRVA? HABS": CALL IBWRT (SCOPE%, CMD$ ) : 
CALL IBRD (SCOPE%, RSP$) : PRINT RSP$ 

Response message: 

C2:CRVA HABS,34.2E-6 S, 244 E-3 V 

CURSOR_SET, PARAMETER_VALUE, PER_CURSOR_VALUE , 
XY_CURSOR_VALUE 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 



DATA_POINTS, DPNT 

Command/ Query 



The DATA_POiNTS command is used to control whether the 
waveform sample points are shown as single display pixels or are 
made bold. 

The response to the d at a_p o i n t s ? query indicates whether the 
waveform sample points are being displ^ed as sin^e displ^ pixels or 
in bold face. 



Data_PoiNTs <State> 

<state> : = {normal, bold} 

Data_PoiNTs? 

Data_PoiNTs <State> 

The following hi^i^ts the waveform sample points: 

CMD$="DPNT BOLD": CALL IBWRT ( SCOPE% , CMD$ ) 
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RemotB Conbol Commands and Quaies 



MISCELLANEOUS 

DESCRIPTION 

COMMAND SYNTAX 



QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 



DATE 

Command/ Query 



The DATE command changes the date/ time of the oscilloscope's 
internal real-time clock. 

The DATE ? query returns the current dat^ time setting. 

DATE <day>, <month>, <year>, <hour>, <minute>, <second> 
<day> : = 1 to 31 

<month> : = { JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, 
OCT, NOV, dec} 

<year> : = 1990 to 2089 
<hour> : = 0 to 23 
<minute> : = 0 to 59 
<second> : = 0 to 59 

TIP; You need only specify those DATE parameters iq) to and 
including the parameter to be changed in order to change the 
year setting: day, month and year. The tirrK settings will 
remain unclmiged. But to change the second setting all the 
DATE pararr^ters mustbe speciSed with the required settings. 




DATE? 



DATE <day>, <month>, <year>, <hour>, <minute>, <second> 



This will change the date to January 1, 1997 and the time to 1:21:16 
p.m. (13:21:16 in 24-hour notation): 

CMD$="DATE 1, JAN, 1997, 13, 21, 16" : CALL 
IBWRT (SCOPE%, CMD$) 
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STATUS 



DDR? 

Query 



DESCRIPTION The ddr? query reads and clears the contents of the Device 

D ependent or device specific error Register (D D R). In the case of a 
hardware failure, the D D R register specifies the origin of the failure. 
The following table gives details. 



Bit 


Bit Value 


Description | 


15...14 




0 


Reserved 


13 


8192 


1 


Timebase hardware failure detected 


12 


4096 


1 


Trigger hardware fahuie detected 


11 


2048 


1 


Channel 4 hardware fahuie detected 


10 


1024 


1 


Channel 3 hardware fahuie detected 


9 


512 


1 


Channel 2 hardware fahuie detected 


8 


256 


1 


Channel 1 hardware fahuie detected 


7 


128 


1 


External input overload condition detected 


6...4 




0 


Reserved 


3 


8 


1 


Channel 4 overload condition detected 


2 


4 


1 


Channel 3overload condition detected 


1 


2 


B 


Channel 2 overload condition detected 


0 


1 


5 


Channel 1 overload condition detected 



QUERY SYNTAX DDR? 

RESPONSE EORMAT DDR <value> 

<value> : = 0 to 65535 
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RemotB Conbol Commands and Quaies 



AVAILABILITY 
EXAMPLE (GPIB) 

RELATED COMMANDS 



<value> : Bit 2, 3, 10, 11 only on four-channel Waverunner 
oscilloscopes. 

The following reads the contents of the D D R register 

CMD$="DDR?": CALL IBWRT ( SCOPE% , CMD$ ) : 
CALL IBRD (SCOPE%, RSP$) : PRINT RSP$ 

Response message: 

DDR 0 

ALL_STATUS, *CLS 



LTXXX-RCM-E Rev B 



I SSUE D : January 2002 



105 




Part Two: COMMANDS 



FUNCTION 


DEFINE, DEF 

Command/ Query 


DESCRIPTION 


The DEFINE command specifies the mathematical expression to 
be evaluated by a function. This command is used to control all 
math tools and zoom in the standard oscilloscope as well as those in 
the Extended Math and WaveAnalyzer options. See the Operator's 
Manual for more about Waverunner Math T ools. 


COMMAND SYNTAX 


<function> : DEFine EQN, '<equation>' 
[, <param_name>, <value>, ...] 


NOTE; Function parameters aw gwiqied in pairs. TheOrstin the pair names the variable to be 
moditied, <param_name>, while the second one gives the new value to be assigned, ^irs can be given 
in any order and restricted to the variables to be changed. 


S^ce (blank) charmiers inside equations aw optional — 


QUERY SYNTAX 


; 

<function> : DEFine? 



RESPONSE FORMAT <function> : DEFine eqn, '<equation>' [,maxpts, <max_points>] 

[, SWEEPS, <maK_sweeps>][, weight, <weight>][, bits, <bits>] 



Function Parameters 


<paiam_iiame> 


<value> 


Description 


BITS [ 


<bits> 


Number of ERES bits 


CENTER 


<center> | 


Horizontal center position for histogram display. 


EQN 


'<equation>' I 


Eunction equation as defined below 



LENGTH <length> j Number of points to use from first waveform 

MAX_EVENT s <max_values> | Maximum number of values in histogram 

MAXBINS <bms> I Number of bins in histogram 

MAXP T s <max_points> I Maximum number of points to compute 
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Remote Conbol Commands and Quaies 



START 


<start> 


Starting point in second waveform 


SWEEPS 


<max sweeps> 


Maximum number of sweeps 


UNITS 


<units> 


Physical units 


VERT 


<vert scale> 


Vertical scaling type 


WEIGHT 


<weight> 


Continuous Average wei^t 


\ WIDTH 


<width> 


Width of histogram display 


1 WINDOW 


<window type> 


FFT window function 



Function EquationsAnd Names 



NOTE: These aw available accoiding to the options installed in your U^Twm&:' oscilloscope. See 
Ch^ter 5 of the Operator's Manual for math and waveform processing options. 



-<source> 

1 


Negation 


+<source> 


Identity 


<source> 


<sourcel> - <source2> 


Subtraction 


<sourcel> + <source2> 


Addition 


<sourcel> / <source2> 


Ratio 


<sourcelxsource2> j 


Multiplication 


i/<source> 


Reciprocal 


ABS (<source>) | 


Absolute Value 


AVGC (<source>) 


Continuous Average 


AVGS (<source>) 


Average Summed 


DERI (<source>) 


Derivative 


ERES (<source>) 


Enhanced Resolution 


EXP (<source>) 


Exponential (power of e) 


EXP 10 (<source>) 


Exponential (power of 10) 


EXTR (<source>) 


Extrema (Roof and Eloor) 
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Part Two: COMMANDS 



NOTE; For FFT functions, the source must be a time-domain, single-segment waveform 



FFT (<SOUTCe>) 


Fast Fourier Transform (complex result) 


— 


FLOOR (EXTR (<SOUTCe>) ) 


Floor (Extrema source only) 






HiST(<custom line>) 


Histogram of parameter on custom line 


IMAG (FFT (<SOUTCe>) ) 


Imaginary part of complex result 


INTG ( <souTce> [{ + ,-} <addend> ] ) 


Integral 


LN (<source>) 


Logarithm base e 


LOG 10 (<source>) 


Logarithm base 10 


MAG (AVGP (<function>) ) 


FFT power average of magnitude 


NOTE; For FFT Avemge functions, the source waveform must abo be detined as an FFT function 




MAG (FFT (<SOUTCe>) ) 


Magnitude of complex result 


B 


PHASE (FFT (<SOUTCe>) ) 


Phase angle (degrees) of complex result 




PS (AVGP (<function>) ) 


FFT Average of power ^ectrum 


PS (FFT (<source>) ) 


Power ^ectrum 


PSD (AVGP (<function>) ) 


FFT power average of power density 


PSD (FFT (<SOUTCe>) ) 


Power density 


REAL (FFT (<SOUTCe>) ) 


Real part of complex result 


RESC ([{ + ,-}] [<multiplier>*] <source> [{ + ,-} 
<addend>] ) 


Rescale 


ROOF (EXTR (<source>) ) 


Roof (Extrema source only) 


siNX (<source>) 


Sin(x)/ X interpolator 


SQR (<source>) 


Square 


SORT (<source>) 


Square Root 


ZOOMONLY (<extended source>) 


Zoom only (No Math) 
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NOTE: The numbers in CUSTI CUST4 CUST3, CUST4 and CUSTSueferto the line numbers of the 


vtoujni pauuiMtJwis, 




— 


SOURCE VALUES 


<sourceN> : = (ta, tb, tc, td, mi, m2, m3, m4, ci. 


r 



C2, C3, C4} 

<function> : = {ta, tb, tc, td} 

<custom_lme> : = {cusTi, cust2, cust3, cust4, 
CUST5} 

<extended_source> : = {ci, C2, C3,C4, ta, tb, tc, 

TD, Ml, M2, M3, M4} 



VALUES TO DEFINE NUMBER 

OF POINTS^ SWEEPS: <max_points> : = 50 to 10 000 000 

<max sweeps> : = 1 to 1000 

<max_sweeps> : = 1 to 1 000 000 (with WaveAnalyzer only) 
<max_sweeps> : = 1 to 50 000 

VALUES FOR RESCALE 

FUNCTION: <addend> : = 0.0 to lel5 

<multiplier> : = 0.0 to lel5 

<units> : = {unchanged, a, cel, c, hz, k, n, ohm, pal, v, w, db, 

DEG, PCT, RAD, S} 



1 Rescale Physical Units Value Notation 


L UNCHANGED 


The unit remains unchanged. 


PAL 


Pascal 


A 


Amperes 


V 


Volt 


CEL 


Celcius 


W 


Watt 


C 


Coulomb 


DB 


decibel 


HZ 


Hertz 


DEG 


degree 


K 


Kelvin 


PCT 


percent 


N 


Newton 


RAD 


radian 


OHM 


Ohm 


S 


second 
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VALUES FOR SUMMATION 

AVERAGE AND ERE S: <weight> : = {l, 3, 7, 15, 31, 63, 127, 255, 511, 1023} 

<bitS> : = {0.5, 1.0, 1.5, 2.0, 2.5, 3.0} 



VALUES FOR EFT WINDOWS: <window_type> : = {blha, fltp, hamm, hann, rect} 



1 EFT \Mndow Function N otation 


LHA 


Blackman- Harris window 


FLTP 


Flat Top window 


HABMM 


Hamming window 


HANN 


von Hann window 


1 RECT 


Rectangular window 



HISTOGRAM VALUES <maxbins> : = {2 0, 50, lOO, 200, 500, 1000, 2000} 

<max_events> : = 20 to 2e9 (in a 1-2-5 sequence) 

<center> : = -lel5 to lel5 

<width> : = le-30 to le30 (in a 1-2-5 sequence) 

<vert_scale> : = {lin, log, constmax} 



' 


Histogram Notation 


, LIN 


Use linear vertical scaling for histogram di^lay 


LOG 


Use log vertical scaling for histogram di^lay 


CONSTMAX 


Use constant maximum linear scaling for histogram 
di^lay 



PRML CORRELATION VALUES <lenqth> : = 0 to 10 divisions 

<start> : = 0 to 10 divisions 

AVAILABILITY <sourceN > : = {C3, C4} only on four-channel oscilloscopes. 

<extended_source> : = {C3, C4} only on four-channel oscilloscopes 

SWEEPS is the maximum number of sweeps (Average and Extrema 
only). 
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EXAMPLES (GPIB) 



NOTE; The pair SWEEPS, <max_ sweqps> applies only to the 
summed averaginff (A VGS). 



The following defines Trace A to compute the summed average of 
Channel 1 using 5000 points over 200 sweeps: 



CMD$="TA:DEF 

EQN, 'AVGS (Cl) ' , MAXPTS, 5000, SWEEPS, 200" : 



CALL IBWRT (SCOPE%, CMD$) 

The following defines Trace A to compute the product of Channel 1 
and Channel 2, using a maximum of 10 000 input points: 

CMD$="TA:DEF EQN, 'Cl *C2 ', MAXPTS , 1 0 0 0 0 " : CALL 
IBWRT (SCOPE%, CMD$) 

The following defines Trace A to compute the Power Spectrum of the 
FFT of Channel 1. A maximum of 1000 points will be used for the 
input. The window function is Rectangular. 

CMD$="TA:DEF EQN, 'PS (FFT ( Cl ))', MAXPTS , 1 0 0 0 , WINDOW, 
RECT": CALL IBWRT (SCOPE%, CMD$ ) 

The following defines Trace B to compute the Power Spectrum of the 
Power Average of the FFT being computed by Trace A, over a 
maximum of 244 sweeps. 

CMDS="TB:DEF EQN, 'PS (AVGP (TA) ) ' , SWEEPS, 244" : 
CALL IBWRT (SCOPE%, CMD$) 

The following defines Trace C to construct the histogram of the aU rise 
time measurements made on source Channel 1. The rise time 
measurement is defined on custom line 2. The histogram has a linear 
vertical scaling and the rise time parameter values are binned into 100 
bins. 



CMD$="PACU 2, RISE, Cl" :CALL IBWRT ( SCOPE% , CMD$ ) 
CMD$="TC:DEF 

EQN, 'HIST (CUST2) ' ,VERT, LIN,MAXBINS, 100" : 

CALL IBWRT (SCOPE%, CMD$) 



RELATED COMMANDS 



FIND_CTR_RANGE, FUNCTION_RESET, INR?, 
PARAMETER_CUSTOM, PARAMETER_VALUE ? , 
PAS S_FAI L_COND I T I ON 



LTXXX-RCM-E Rev B 



I SSUE D : January 2002 



m 





Part Two: COMMANDS 



MASSSTORAGE 
DESCRIPTION 
COMMAND SYNTAX 

AVAILABILITY 
EXAMPLE (GPIB) 
RELATED COMMANDS 



DELETE_FILE, DELF 

Command 



The DELETE_F ILE command deletes files from the currently 
selected directory on mass storage. 



DELete_Fiie DISK, <device>, FILE, '<filename>' 
<device> : = {card, flpy, hdd} 

<filename> : = An alphanumeric string of up to ei^t characters, 
followed by a dot and an extension of up to three characters. 

<device> : card available only when Memory Card option is fitted. 
<device> : hdd available only when removable Hard Disk Drive 
option is fitted. 



The following deletes a front panel setup from the memory card: 

CMD$ = "DELF DISK, CARD, FILE, 'POOl.PNL'"; 

CALL IBWRT (SCOPE%, CMD$) 



DIRECTORY, FORMAT_CARD, FORMAT_FLOPPY, 
FORMAT_HDD 



U2 



I SSUE D : January 2002 



LTXXX-RCM-E Rev B 




RemotB Conbol Commands and Quaies 



MASSSTORAGE 

DESCRIPTION 

COMMAND SYNTAX 
QUERY SYNTAX 

RESPONSE EORMAT 
AVAILABILITY 



DIRECTORY, DIR 

Command/ Query 



The DIRECTORY command is used to manage the creation and 
deletion of file directories on mass storage devices. It also allows 
selection of the current working directory and listing of files in the 
directory. 

The guery response consists of a double-guoted string containing a 
D 0 S-like listing of the directory. If no mass storage device is 
present, or if it is not formatted, the string will be empty. 



DIRectory 

DISK, <device>, action, <action>, '<directory>' 



DIRectory? DISK, <device> [, '<directory>' ] 

<device> : = {card, flpy, hdd} 

<action> : = {create, delete, switch} 

<directory> : = A legal DOS path or filename. (This can include the 
A ' character to define the root directory.) 



NOTE; The query DIRectoiy_ list? is also accepted for back ward 
mrrqfatrbility but may not be supported in the future. 



DIRectory DISK, <device> "<directory> 



<directory> : = A variable length string detailing the file content of 
the memory card, floppy disk or hard disk. 



<device> : card available only with the Memory Card option installed. 

<device> : hdd available only with the removable Hard Disk option 
installed. 
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EXAMPLE (GPIB) The following asks for a listing of the directory of the memory card: 

CMD$="DIR? DISK, CARD": CALL 
IBWRT (SCOPE%, CMD$) : 

CALL IBRD (SCOPE%, RSP$) : PRINT RSP$ 

Response message: 



DIR " 



Directory 




LECROY 


1 DIR of 04-MAR-1994 


10:46:20 


on Memory Card 




SCI 


000 


2859 


19-DEC-199416:33:06 


SCI 


001 


2859 


19-DEC-199416:34:32 


TESTS 


002 


20359 


12-MAR-199413 : 34 : 12 


3 File ( s ) 


1948672 


bytes free 
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DISPLAY DISPLAY, DISP 

Command/ Query 

DESCRIPTION TheDiSPLAY command controls the display screen of the 

oscilloscope. When remotely controlling the oscilloscope and you do 
not need to use the display, it can be useful to switch off the display 
via the D I splay off command. This improves oscilloscope 
response time, since the waveform graphic generation procedure is 
suppressed. 



The response to the D i s p la Y ? guery indicates the di^l^ state of 
the oscilloscope. 





NOTE; When you set the display to OFF, the iwl-thne clock 




and the message held aw iqjdated. Butwavefonnsand 
associated texts rnmin unchanged. 






— 


COMMAND SYNTAX 


Display <state> 
<state> : = {on, off} 


r 


QUERY SYNTAX 


Display? 




RESPONSE EORMAT 


Display <state> 




EXAMPLE (GPIB) 


The following turns off the di^lay: 






CMD$="DISP OFF": CALL IBWRT ( SCOPE% , CMD$ ) 
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DISPLAY 
DESCRIPTION 
COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 



DOT_JOIN, DTJN 

Command/ Query 

The DOT_JOiN command controls the interpolation lines between 
data points. 

DoT_JoiN <state> 

<state> : = {on, off} 

DoT_JoiN? 



DoT_JoiN <state> 

The following turns off the interpolation hnes: 

CMD$="DTJN OFF": CALL IBWRT ( SCOPE% , CMOS ) 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



DUAL_ZOOM, DZOM 

Command/ Query 



By setting D UAL ZO 0 M 0 N, the horizontal magnification and 
positioning controls are applied to all expanded traces 
simultaneously. This command is useful if the contents of all 
expanded traces are to be examined at the same time. 

The D UAL ZO 0 M? guery indicates whether multiple zoom is enabled 
or not. 



NOTE: This command has the san^ effect as MULTIZOO 


M. 




r 



Duai_zooM <mode> 



<mode> : = {on, off} 



Dual_ZOoM? 

Duai_zooM <mode> 

The following turns dual zoom on: 

CMD$="DZOM ON": CALL IBWRT ( SCOPE% , CMD$ ) 
HOR_MAGNIFY, HOR_POSITION, MULTI_ZOOM 
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STATUS 
DESCRIPTION 
COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



ENABLE_KEY 

Command/ Query 

The ENABLE KEY command allows you to assign menus to the 
lower six menu buttons for use in local mode. 

ENABLE_KEY <State> 

<state> : = {ON, OEE} 

ENABLE_KEY? 

ENABLE KEY <state> 

CMD$="ENABLE_KEY" : CALL IBWRT ( SCOPE% , CMD$ ) 

KEY 
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STATUS 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



*ESE 

Command/ Query 



The *ESE command sets the Standard Event Status Enable register 
(E SE ). This command allows one or more events in the E SR register 
to be reflected in the E SB summary message bit (bit 5) of the STB 
register. Eor an overview of the E SB defined events refer to the E SR 
table on page 121. 

The * E s E ? query reads the contents of the E SE register. 



*ESE <value> 
<value> : = 0 to 255 



*ESE? 



*ESE <value> 



The following allows the E SB bit to be set if a user request (URQ bit 
6, i.e. decimal 64) and/ or a device dependent error (DDE bit 3, i.e. 
decimal 8) occurs. Summing these values yields the E SE register 
mask 64+8=72. 

CMD$="*ESE 72": CALL IBWRT ( SCOPE% , CMD$ ) 



*ESR 
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STATUS 

DESCRIPTION 

QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*ESR? 

Query 



The *ESR? query reads and clears the contents of the Event Status 
Register (E SR). The re^onse represents the sum of the binary values 
of the register bits 0 to 7. The ti)le below gives an overview of the 
E SR register structure. 



*ESR? 



*ESR <value> 
<value> : = 0 to 255 



The following reads and clears the contents of the E SR register: 

CMD$="*ESR?" : CALL IBWRT ( SCOPE% , CMD$ ) : 
CALL IBRD (SCOPE%, RSP$) : PRINT RSP$ 

Response message: 

*ESR 0 



ALL_STATUS, *CLS, *ESE 
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ADDITIONAL INFORMATION 



1 Standard Event Status Register (ES) 


Bit 


Bit Value 


Bit Name 


Description 


See Note... 


15...8 






0 1 Reservedby IEEE 488.2 




7 


128 


PON 


1 


Power off-to-0 N transition has occurred 


1. 


6 


64 


URQ 


1 


User ReQuest has been issued 


2. 


5 


32 


CME 


1 


CoMmand parser Error has been detected 


3. 


4 


16 


EXE 


1 


Execution Error detected 


4. 


3 


8 


DDE 


1 


Device specific Error occurred 


5. 


2 


4 


QYE 


1 


QuerY Error occurred 


6. 


1 


2 


RQC 


0 


0 sdlloscope never requests bus control 


7. 


0 


1 


OPC 


0 


0 peration Complete bit not used 


8. 



NOTE: (refer to table above) 



1 TbePowerOn (PON) bit is alwa^ turned on (1) when the unit is powered up. 

2 The Uso' Request (URQ) bit is set true (1) when a softkey is pressed. An associated register URR 
identrSes which key was selected For further details refer to the URR? query. 

3. The CoMmand parserErrorbit (CME) is set true (h whenever a command syntax ermris 
detected The CME bit has an associated CoMmand parser Register (CMR) which spedSes the 
error code. Refer to the query CMR? for further details. 



4 The Execution Error bit (EXE) is set true (1) when a corrunand carmot be executed due to some 
device condition (e.g. oscilloscope in local state) ora semantic error. The EXE bit has an 
associated Execution Error Register (EXR) which speciOes the error code. Refer to query EXR? 



for further details. 


1 










■ 
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5. The Device spedffc Error (DDE) is set true (h whenever a hardware imiure has occurred at 
power-ip, or execution tune, such as a channei overioad condition, a trigger or a tunehase circuit 
defect The origin of the fyiiure can he iocaiized via the DDR? or the seif test *TST? query. 

6 The Qu&y Error hit (QYE) is set true (1) nfimeuer(a) an attenqjt is made to read data hum the 
Output Queue when no output is dther present orpmding, (h) data in the Output Queue has 
heeniost (c) hoth output and input buffers are hiii (deadiock state), (d) anattmq>tisrrmdebythe 
controiier to rmd before having sent an <END>, (e) a command is received before the response to 
the previous query was read (output buffer Hushed). 

7. The ReQuest Control bit (RQC) is always faise(0), astheosdUosmpehasnoGPlBcxmtroliing 
capabHity. 

& The operation Congjiete bit (OPC) is set true (1) whenever *OPCh^ been received, since 

comnands and queries are stdctiy executed in sequentiai order. The osciiioscope starts processing 
a command oniywiKn the previous command has been entirety executed. I — 
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RemotB Conbol Commands and Quaies 



STATUS 

DESCRIPTION 

QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 
RELATED COMMANDS 



EXR? 

Query 

The EXR? query ruads and clears the contents of the Execution error 
Register (EXR). The EXR register specifies the type of the last error 
detected during execution. Refer to the table next page. 

EXR? 

EXR <value> 

<value> : = 21 to 64 

The following reads the contents of the EXR register: 

CMD$="EXR?"; CALL IBWRT ( SCOPE% , CMD$ ) : 

CALL IBRD (SCOPE%, RSP$) : PRINT RSP$ 

Response message (if no fault): 

EXR 0 

ALL_STATUS, *CLS 
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ADDITIONAL INFORMATION 



Execution Error Status Register Structure (EXR) 


Value 


Description 


21 1 


Permission error. The command cannot be executed in local mode. 


22 


Environment error. The oscilloscope is not configured to correctly process a command. For i 

instance, the oscilloscope cannot be set to RI S at a slow timebase. 


23 


Option error. The command applies to an option which has not been installed. 


24 


Unresolved parsing error. 


25 


Parameter error. Too many parameters specified. ! 


26 


Non-implemented command. 


30 


Hex data error. A non- hexadecimal character has been detected in a hex data block. 


31 


Waveform error. The amount of data received does not correspond to descriptor indicators. 


32 


Waveform descriptor error. An invalid waveform descriptor has been detected. I 


33 


Waveform text error. A corrupted waveform user text has been detected. 


34 


Waveform time error. Invalid RIS or TRIG time data has been detected. 


35 


Waveform data error. Invalid waveform data have been detected. 


36 


Panel setup error. An invalid panel setup data block has been detected. 


50 


No mass storage present when user attempted to access it. * 


51 


Mass storage not formatted when user attempted to access it. * 


53 


Mass storage was write protected when user attempted to create, or a file, to delete a file, or to 
format the device. * 


54 


Bad mass storage detected during formatting. * i 


55 


Mass storage root directory full. Cannot add directory. * 


56 


Mass storage full when user attempted to write to it. * 


57 


Mass storage file sequence numbers exhausted (999 reached). * 


58 


Mass storage file not found. * 


59 


Requested directory not found. * 


61 


Mass storage filename not DOS compatible, or illegal filename. * 


62 


Cannot write on mass storage because filename already exists * 



* Only with memoiy card or removable hard disk option. 
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RemotB Conbol Commands and Quaies 



DISPLAY 

DESCRIPTION 
COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 



FAT_CURSOR, FATC 

Command/ Query 



FAT_ CURSOR controls the width of the cursors. 

FAT_CURSOR, FATC <State> 

<state> : = {on, off} 

FAT_CURSOR? 

FAT_cuRSOR <state> 

The following sets the cursor appearance to fat: 

CMD$="FAT_CURSOR ON"; CALL IBWRT (SCOPE%, CMD$ ) 
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MASSSTORAGE 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 

RESPONSE EORMAT 

AVAILABILITY 
EXAMPLE (GPIB) 

RELATED COMMANDS 



FILENAME, FLNM 

Command/ Query 



The F I LENAME command is used to change the default filename given 
to any traces, setups and hairi copies when they are being stored to a 
mass storage device. 



FiLeNaMe TYPE, <type>, FILE, '<filename>' 

<type> : = {Cl, C2, C3, C4, TA, TB, TC, TD, SETUP, HCOPY } 

<filename> : = For Cl to TD, an alphanumeric string of up to ei^t 
characters forming a legal DOS filename. Up to five characters for 

SETUP and HCOPY. 



NOTE; No extmsion can be specMed, as the oscilloscope 
automatically does this. 



FiLeNaMe? TYPE,<type> 

<type> : = {all. Cl, C2, C3, C4, TA, TB, TC, TD, SETUP, 

HCOPY} 



FiLeNaMe 

TYPE, <type>, FILE, "<filename>"[,TYPE, <type>, FILE, "<filename> 
"...] 



<trace> : = {C3, C4} available only on four-channel oscilloscopes. 

The following designates channel 1 waveform files as TE STPNT6.xxx" 
where xxx is a numeric extension assigned by the scope: 

CMD$="FLNM TYPE,C1, FILE, 'TESTPNT6'": 

CALL IBWRT (SCOPE%, CMD$) 



DIRECTORY, FORMAT_CARD, FORMAT_FLOPPY, 
FORMAT_HDD, DELETE_FILE 



126 



I SSUE D : January 2002 



LTXXX-RCM-E Rev B 




RemotB Conbol Commands and Quaies 



FUNCTION 

DESCRIPTION 
COMMAND SYNTAX 

AVAILABILITY 
EXAMPLE (GPIB) 

RELATED COMMANDS 



F IND_CTR_RANGE , FCR 

Command 



The F IND_CTR_RANGE command automatically sets the center and 
width of a histogram to best display the accumulated events. 



<function> : Find_Ctr_Range 

<function> : = {ta,tb,tc,td} 



Only available with an option installed that includes Histograms. 



Assuming that Trace A (ta) has been defined as a histogram of one of 
the custom parameters, the following example will determine the best 
center and width and then rescale the histogram: 

CMD$="TA:FCR" : CALL IBWRT ( SCOPE% , CMD$ ) 



DEFINE, PACU 
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MASSSTORAGE 

DESCRIPTION 

COMMAND SYNTAX 
QUERY SYNTAX 
RESPONSE EORMAT 



AVAILABILITY 
EXAMPLE (GPIB) 

RELATED COMMANDS 



FORMAT_CARD, FCRD 

Command/ Query 



The FORMAT_CARD command formats the memory card according to 
the PCMIA/JEIDA standard with a DOS partition. 

The FORMA T_CARD ? query returns the status of the card. 



Format_CaRD 



Format_CaRD? 



Format_CaRD <card_ status> [ , <read/ write> , <free_ ^ace> , 
<card_size>, <battery_status>] 

<card_status> : = {none, bad, blank, dir_missing, ok} 

<read/ write> : = {wp, rw} 

<free_space> : = A decimal number giving the number of bytes still 
available on the card 

<card_size> : = A decimal number giving the total number of bytes on 
the card. 

<battery_status> : = {bat_ok, bat_low, bat_bad} 

Available only with the Memory Card option installed. 



The following will first format a memory card and then verify its status: 

CMD$="FCRD": CALL IBWRT ( SCOPE% , CMD$ ) 
CMD$="FCRD?" : CALL IBWRT ( SCOPE% , CMD$ ) : 

CALL IBRD (SCOPE%, RSP$) : PRINT RSP$ 

Response message: 

FCRD OK, RW, 130048, 131072, BAT_0K 



DIRECTORY 
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ADDITIONAL INFORMATION 



1 




Notation 


1 BAD 




Bad card after formatting 


BAT BAD 




Bad battery or no battery 


BAT LOW 




Battery should be replaced 


BAT OK 




Battery is in order 


BLANK 




Current directory empty 


DIR_ MISSING 




No subdirectory present. The directory "LECROY 1 DIR" will be 
automatically created with the next "store" command 


NONE 




No card 


OK 




Card is correctly formatted 


RW 




Read/ Write authorized 


WP 




Write protected 
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MASSSTORAGE 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 
RELATED COMMANDS 



FORMAT_FLOPPY, FFLP 

Command/ Query 

The FORMAT_FLOPP Y command formats a floppy disk in the Double 
D ensity or Hi^ D ensity format. 

TheFORMAT_FLOPPY? query retums the status of the floppy disk. 

Format_FLoPpy [<type>] 

<type> : = {dd, hd} 

If no argument is supplied, HD is used by default. 



Format_FLoPpy? 



Format_FioPpy <floppy_status>[, <read/ wiite> , <free_space>, 
<floppy_size>] 

<floppy_status> : = {none, bad, blank, dir_missing, ok} 
<read/ write> : = {wp, rw} 

<free_space> : = A decimal number giving the number of bytes still 
available on the floppy. 

<floppy_size> : = A decimal number giving the total number of bytes 
on tire floppy. 



The following will first format a floppy in the D ouble D ensity (720 kB) 
format and then verify its status: 

CMD$="FFLP DD" : IBWRT ( SCOPE% , CMD$ ) CMD$="FFLP ? " : 
CALL IBWRT (SCOPE%, CMD$) : 

CALL IBRD (SCOPE%, RSP$) : PRINT RSP$ 

Response message: 

FFLP OK, RW, 728064, 737280, 



DIRECTORY 
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ADDITIONAL INFORMATION 



r 




Notation 


BAD 




Bad floppy after formatting 


BLANK 




Current directory empty 


DD 




Double Density 720 kB formatted 


DIR_ MISSING 


, 


No subdirectory present. The directory "LECROY 1 DIR" will be 
automatically created with the next "store" command. 


HD 




Hi^ Density 1.44 MB formatted 


NONE 




No floppy 


OK 




Eloppy is correctly formatted 


RW 




Read/ Write authorized 


WP 




Write protected 
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MASSSTORAGE 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 



AVAILABILITY 
EXAMPLE (GPIB) 



FORMAT_HDD , FHDD 

Command/ Query 

The FORMAT_HDD command formats the removable hard disk 
according to the PCMIA/ JE ID A standard with a D 0 S partition. 

The FORMA T_HDD ? query returns the status of the hard disk. 

Format_HDD <type> 

<type> : = {quick, full}. If no argument is given, QUICK is 
us^. 



Format_HDD? 



Format_HDD <hdd_status>[, <read/ write> , <free_^ace>, 
<hdd_size>] 

<hdd_status> : = {none, bad, blank, dir_missing, ok} 

<read/ write> : = {wp, rw} 

<free_space> : = A decimal number giving the number of byte still 
available on the hard disk 

<hdd_size> : = A decimal number giving the total number of bytes 
on the hard disk. 

Available only when the removable hard disk option is fitted. 



The following will first format a hard disk and then verify its status: 

CMD$="FHDD": CALL IBWRT ( SCOPE% , CMD$ ) 
CMD$="FHDD?" : CALL IBWRT ( SCOPE% , CMD$ ) : 

CALL IBRD (SCOPE%, RSP$) : PRINT RSP$ 

Response message: 

FHDD OK, RW, 3076096, 105744896 



132 



I SSUE D : January 2002 



LTXXX-RCM-E Rev B 




Remote Conbol Commands and Quaies 



RELATED COMMANDS DIRECTORY 



ADDITIONAL INEORMATION 



r 


Notation 


BAD 


Bad hard disk after formatting 


BLANK 


Current directory empty 


DIR_ MISSING 


No subdirectory present. The directory "LECROY 1 DIR" will be 
automatically created with the next "store" command 


NONE 


No hard disk 


OK 


Hard disk is correctly formatted 


RW 


Read/ Write authorized 


WP 


Write protected 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 



FULL_SCREEN, FSCR 

Command/ Query 



The FULL_SCREEN command is used to contrul whether the currently 
selected grid style is displayed in normal presentation format or with a 
full-screen grid. In Full Screen format, the waveform display areas are 
enlarged to the maximum possible size. 

The response to the full_screen? query indicates whether or not 
the display is operating in Full Screen presentation format. 



FullSCReen <State> 

<state> : = {on, off} 



FullSCReen? 



FullSCReen <State> 

The following enables the Full Screen presentation format: 

CMD$="FSCR ON": CALL IBWRT ( SCOPE% , CMD$ ) 



m 



I SSUE D : January 2002 



LTXXX-RCM-E Rev B 




RemotB Conbol Commands and Quaies 



FUNCTION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



FUNCTION_RESET, FRST 

Command 

The FUNCTiON_RESET command resets a waveform processing 
function. The number of sweeps will be reset to zero and the process 
restarted. 



<functi.on> : Function_ReSeT 

<function> : = {ta,tb,tc,td} 

Assuming that Trace A (TA) has been defined as the summed average 
of Channel 1, the following will restart the averaging process: 

CMD$="TA:FRST" ; CALL IBWRT ( SCOPE% , CMD$ ) 
DEFINE, INR 
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ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE 

RELATED COMMANDS 



GLOBAL_BWL, GBWL 

Command/ Query 



The GLOBAL_BWL command txims on or off the G lobal Bandwidth 
Limit. When on, the selected bandwidth limit will apply to aU channels; 
when off, a bandwidth limit can be set individually for each channel (see 
BWL, page 69). The re^onse to the global_bwl? query indicates 
whether the G lobal Bandwidth Limit is on or off. 



Global_BWL <mode> 
<mode> : = {off, on} 



Global_BWL? 



Giobai_BWL <mode> 



The following deactivates the Global Bandwidth Limit, allowing a 
Bandwidth Limit to be set individually for each channel (using the BWL 
command syntax for individual channels): 

CMDS="GBWL OFF": CALL IBWRT ( SCOPE% , CMD$ ) 



BANDWIDTH_LIMIT 
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RemotB Conbol Commands and Quaies 



DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 



GRID 

Command/ Query 

The GRID command defines the style of the grid used in the display. 
The GRID? query returns the grid style currently in use. 

GRID <grid> 

In standard displ^: 

<grid> : = {single, dual, quad, octal} 

InXY displ^: 

<grid> : = {single, dual, xyonly} 

GRID? 

grid <grid> 

The following sets the screen di^lay to dual grid mode: 

CMD$="GRID DUAL": CALL IBWRT ( SCOPE% , CMD$ ) 
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HARD COPY 
DESCRIPTION 

COMMAND SYNTAX 



QUERY SYNTAX 
RESPONSE EORMAT 

AVAILABILITY 



HARDCOPY_SETUP , HCSU 

Command/ Query 



The HARDCOP Y_SETUP command configures the oscilloscope's 
harxicopy driver. It enables you to specify the device type and 
transmission mode of the hardcopy unit connected to the oscilloscope. 
One or more individual settings can be changed by specifying the 
appropriate keyword(s), together with the new valuefs). following 

pages for command notation and printer or plotter model availability. 



HardCopy_SetUp DEV, <device>, PORT, <pOlt>, PFEED, 
<page_feed>, pens, <plot_pens>, psize, <p^er_size> cmdiv, 
<cmdiv>, AUTO, <auto>, format, <foimat>, bckg, <bckg> 

<device> : = {bmp, bmpcomp,canoncol, epson, epsoncol, 

HPDJ, HPDJBW, HPPJ, HPTJ, HPLJ, HP7470A, HP7550A, 
TIFF, TIFFCOL TIFFCOMP} 

<port> : = {GPIB, RS, cent, FLPY, card, HDD, PRT} 
<page_feed> : = {off, on} 

<plot_pens> : = 1 to 8 
<paper_size> : = {as, a4} 

<cmdiv> : = {1, 2, 5, 10, 20, 50, 100, 200} 

<auto> : = {off, on} 

<format> : = {portrait, landscape} 

<bckg> : = {black, white} 



HardCopy_SetUp? 



HardCopy_SetUp DEV, <device>, PORT, <poit>, 

PFEED, <page_feed>, pens, <plot_pens>, psize, <p^er_size>, 
CMDIV, <cmdiv>, AUTO, <auto>, format, <format>, bckg, <bckg> 



<card> : CARD only with Memory Card option installed. 
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EXAMPLE (GPIB) 

RELATED COMMANDS 
ADDITIONAL INEORMATION 



<poit> : HDD only with removable Hard Disk option installed. 
<port> : PRT only with internal graphics printer installed. 
<cmdiv> only with internal graphics printer installed. 

<auto> only with internal graphics printer installed. 

<device> See table below. 



The following example selects an EPSO N printer connected via the 
RS232 port: 

CMD$="HCSU PORT, RS, DEV, EPSON" 

CALL IBWRT (SCOPE%, CMD$) 



HARDCOPY_TRANSMIT, SCREEN_DUMP 



Hardcopy command parameters are grouped in pairs. The first in the 
pair names the variable to be modified, while the second gives the new 
value to be assigned. Pairs can be given in any order and restricted to 
those variables to be changed. 

The table below lists the printer and graphic formats you can use for 
producing hardcopies remotely using <device>. 



Notation 


Printer, Plotter or Protocol 


BMP 


BMP 


1 BMP COMP 


BMP compressed 


1 CANONCOL 


Canon 200/ 600/ 800 Series color printers 


1 EPSON 


Epson b & w 


EPSONCOL 


Epson color 


HPLJ 


HP LaserJet 


HPDJ 


HP DeskJet color 


HPDJBW 


HP Desk Jet b & w 


HP7470A 


HP 7470A plotter 


HP7550A 


HP 7550A plotter 


HPGL 


Vector screen file 


TIFF 


TIDE 


TIFFCOL 


TIEE color | 
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The table below gives the Hardcopy command notations and their 
meanings. 



1 Hardcopy Command Notation 


DEV 


Device 


PENS 


Plotter: plot pens 


PFEED 


Page feed 


PORT 


Transmission mode 


CARD 


Memory Card 


HDD 


Hard Disk 


CENT 


Centronics port 


FLPY 


Floppy disk 


GPIB 


IEEE-488 port 


PRT 


Internal printer 


RS 


RS-232-C port 


CMDIV 


Internal printer: cm/ division 


PSIZE 


Plotter: paper size 


AUTO 


Auto print 


, FORMAT 


Orientation of print: Portrait or Landscape 
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HARDCOPY 

DESCRIPTION 

COMMAND SYNTAX 

EXAMPLE (GPIB) 
RELATED COMMANDS 



HARDCOPY_TRANSMIT, HCTR 

Command 



The HARDCOPY TRANSMIT command sends a string of ASCII 
charactens without modification to the hardcopy unit. This allows you 
to control the hardcopy unit by sending device-specific control 
character sequences. It also allows placing of additional text on a 
screen dump for documentation purposes. 



HardCopy_TRansmit '<String>' 

<string> : = Any sequence of ASCII characters or escape sequences. 



NOTE: This command averts the ^ape sequences as 
desaihed under the command COMM_ RS232 Before sending 
the string to the hardmpy unit the esc^resequmce is concerted 
to the ASCII character code. 



I ^ 

The following sends documentation data to a printer: 

CMD$="HCTR 'Data from Oct.l5\r\n"' CALL 
IBWRT (SCOPE%, CMD$) 



HARDCOPY_SETUP, SCREEN_DUMP 
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DISPLAY 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



HOR_MAGNIFY, HMAG 

Command/ Query 



The HOR_MAGNiFY command horizontally expands the selected 
expansion trace by a specified factor. Magnification factors not within 
the range of permissible values will be roimded off to the closest legal 
value. 

If multiple zoom is enabled, the magnification factor for all expansion 
traces is set to the specified factor. If the specified factor is too large 
for any of the expanded traces (depending on their current source), it 
is reduced to an acceptable value and only then applied to the traces. 

The VAB bit (bit 2) in the STB register (see table on page 210) is set 
when a factor outside the legal range is specified. 

The HOR_MAGN I F Y ? query returns the current magnification factor 
for the specified expansion fimction. 



<exp_trace> : Hor_MAGnify <factor> 
<exp_trace> : = {ta, tb, tc, td} 
<factor> : = 1 to 20000 



<exp_SOUrce> : Hor_MAGnify? 

<exp_source> : Hor_MAGnify <factor> 

The following horizontally magnifies Trace A (TA) by a factor of 5: 

CMD$="TA:HMAG 5": CALL IBWRT ( SCOPE% , CMD$ ) 



DUAL_ZOOM, MULTI_ZOOM 



142 



I SSUE D : January 2002 



LTXXX-RCM-E Rev B 




RemotB Conbol Commands and Quaies 



DISPLAY 

DESCRIPTION 



COMMAND SYNTAX 



HOR_POSITION, HPOS 

Command/ Query 



The HOR_p 0 s I T I ON command horizontally positions the geometric 
center of the intensified zone on the source trace. Allowed positions 
range from division 0 through 10. If the source trace was acquired in 
sequence mode, horizontal shifting will only apply to a sin^e segment 
at a time. 

If the multiple zoom is enabled, the difference between the specified 
and the current horizontal position of the specified trace is applied to 
all expanded traces. If this would cause the horizontal position of any 
expanded trace to go outside the left or right screen boimdaries, the 
difference of positions is adapted and then applied to the traces. 

If the sources of expanded traces are sequence waveforms, and the 
multiple zoom is enabled, the difference between the specified and the 
current segment of the specified trace is applied to aU expanded 
traces. If this woitld caitse the segment of any expanded trace to go 
outside the range of the number of source segments, the difference is 
edited and then applied to the traces. 

The VAB bit (bit 2) in the STB register (see table on page 210) is set if 
a value outside the legal range is specified. 

The HOR_p 0 s I T I ON ? query returns the position of the geometric 
center of the intensified zone on the source trace. 



NOTE: Segment number 0 has the special meaning "ShawAU 
Segments Unexpanded". H 



<exp_trace> : Hor_POSition <hor_position> , <segment> 
<exp_trace> : = {ta, tb, tc, td} 

<hor_position> : = 0 to 10 D IV 
<segment> : = 0 to max segments 



NOTE: The segment number is only relevant for waveforms 
accjuired in sequence mode; it is ignored in single waveform 
acquisitions. When the segment number is set to Q all segments 
will be shomi 

The suffix DIVis optional. — 
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QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 
RELATED COMMANDS 



<exp_tlBCe> : Hor_POSition? 



<exp_trace> : Hor_POSition <hor_position>[, <segment>] 



NOTE: The segment number is only given for sequence 
waveforms. 




The following positions the center of the intensified zone on the trace 
currently view^ by Trace A (TA) at division 3: 

CMD$="TA:HPOS 3": CALL IBWRT ( SCOPE% , CMD$ ) 



DUAL_ZOOM, MULTI_ZOOM 
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MISCELLANEOUS 

DESCRIPTION 

QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 



*IDN? 

Query 



The * I DN ? query is used for identification purposes. The response 
consists of four different fields providing information on the 
manufacturer, the scope model, the serial number and the firmware 
revision level. 



*IDN? 



*IDN LECROY, <model>, <serial_number> , <firmware_level> 

<model> := A six- or seven-character model identifier 
<serial_nirmber> : = A nine- or 10-digit decimal code 
<firmware_level> : = two digits giving the major release level 
followed by a period, then one digit giving the minor release level 
followed by a period and a single-digit update level (xx.y.z) 



This issues an identification request to the scope: 

CMD$="*IDN?" : CALL IBWRT ( SCOPE% , CMD$ ) : 
CALL IBRD (SCOPE%, RSP$) : PRINT RSP$ 

Response message: 

*IDN LECROY, 9314CM, 931401000,7.7.0 
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STATUS 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



INE 

Command/ Query 



The INE command sets the Internal state change Enable register 
(INE). This command allows one or more events in the INR 
register to be reflected in the INB summary message bit (bit 0) of 
the STB register. Eor an overview of the INR defined events, refer 
to the table next page. 

The INE ? guery reads the contents of the INE register. 



INE <value> 

<value> : = 0 to 65535 



INE? 



INE <value> 



The following allows the INB bit to be set whenever a screen dump 
has finished (bit 1, i.e. decimal 2), or a waveform has been acguired 
(bit 0, i.e. decimal 1), or both of these. Summing these two values 
yields the INE mask 2+1=3. 

CMD$="INE 3": CALL IBWRT ( SCOPE% , CMD$ ) 



INR? 
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STATUS 



INR? 

Query 



DESCRIPTION The inr? Query reads and clears the contents of the Internal state 

change Register (INR). The INR register (table below) records the 
completion of various internal operations and state transitions. 



Internal State Register Structure (INR) 



Bit 


Bit Value 


Description 


15 




0 


Reserved for future use. 


14 


16384 


1 


Probe was changed. 


13 


8192 


1 


Trigger is ready. 


12 


4096 


1 


Pass/ Fail test detected desired outcome. 


11 


2048 


1 


Waveform processing has terminated in Trace D. 


10 


1024 


1 


Waveform processing has terminated in Trace C. 


9 


512 


1 


Waveform processing has terminated in Trace B. 


8 


256 


1 


Waveform processing has terminated in Trace A. 


7 


128 


1 


A memory card, floppy or hard disk exchange has been detected. 


6 


64 


1 


Memory card, floppy or hard disk has become full in AutoStore Fill mode. 


5 


32 


0 


Reserved for LeCroy use. 


4 


16 


1 


A segment of a sequence waveform has been acquired in acquisition 
memory but not yet read out into the main memory. 


3 


8 


1 


A time-out has occurred in a data block transfer. 


2 


4 


1 


A return to the local state is detected. 


1 


2 


1 


A screen dump has terminated. 


0 


1 


1 


A new signal has been acquired in acquisition memory and read out into the 
main memory. 
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Part Two: COMMANDS 



QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 
RELATED COMMANDS 



INR? 

I NR <state> 

<state> : = 0 to 65535 

The following reads the contents of the INR register: 

CMD$="INR?": CALL IBWRT ( SCOPE% , CMD$ ) 

Response message: 

INR 1026 

i.e. waveform processing in Function C and a screen dump have both 
terminated. 

ALL_STATUS, *CLS, INE 
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WA VE FORM TRANSFER 
DESCRIPTION 



QUERY SYNTAX 



INSPECT?, INSP? 

Query 



The INSPECT ? query allows you to read parts of an acquired 
waveform m Intelligible form. The command is based on the 
explanation of the format of a waveform given by the template (use 
the TEMP LATE ? query to obtain an up-to-date copy). 

Any logical block of a waveform can be inspected using this query by 
giving its name enclosed in quotes as the first (string) parameter (see 
the template itself). 

The special logical block named WAVED ESC can also be inspected in 
more detail. By giving the name of a variable in the block WAVE D E SC, 
enclosed in quotes as the first (string) parameter, it is possible to inject 
only the actual value of that variable. See Chapter 4 for more on 
INSPECT?. 



|~ Notation 


byte 


raw data as integers (truncated to 8 most significant bits) 


float 


normalized data (gain, offset applied) as floating point 
numbers (gives measured values in volts or units) 


WORD 


raw data as integers (truncated to 16 most significant bits) 



<trace> : iNSPect? '<string>' [, <data_type>] 

<trace> : = {ta, TB, TC, TD, mi, m 2, M3, M4, Cl, C2, C3, 
C4} 

<string> : = 

<data_type> : = {byte, word, float} 



NOTE: The optional paiameter <data_ type> appU^ only for 


inspecting the data arrays. It selects the r^iesentation of the 


L 


data. The deMiIt <data_ type> is FLOAT. 


— 
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RESPONSE EORMAT 

AVAILABILITY 
EXAMPLES (GPIB) 



RELATED COMMANDS 



<trace> : iNSPect "<string>" 

<string> : = A string giving name(s) and value(s) of a logical block or a 
variable. 



<trace> : = {C3, C4} only on four-channel oscilloscopes. 



The following reads the value of the ttmebase at which the last 
waveform in Channel 1 was acguired: 

CMDS="C1 : INSP? 'TIMEBASE'" 

CALL IBWRT (SCOPE%, CMD$) 

CALL IBRD (SCOPE%, RSP$) 

PRINT RSP$ 

Response message: 

Cl: INSP "TIMEBASE: 500 US/DIV" 

The following reads the entire contents of the waveform descriptor 
block: 

CMD$="C1 : INSP? 'WAVEDESC'" 

TEMPLATE, WAVEFORM_SETUP 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 



INTENSITY, INTS 

Command/ Query 



The INTENSITY command sets the intensity level of the grid, orthe 
trace or text. 

The intensity level is expressed as a percentage (PCT). A level of 100 
PCT corresponds to the maximum intensity whOe a level of 0 PCT 
sets the intensity to its rriinimiun value. 

The response to the intensity? query indicates the grid and 
trace intensity levels. 



INTenSity GRID, <value>, TRACE, <value> 
<value> : = 0 to 100 [PCT ] 



NOTE: Parameters are gimped in pairs. The Oist of the pair 
names the variable to be modiBed, uhile the second gives the 
new value to be assigned. Pairs can be given in any order and be 
restricted to those variables to be changed. 

ThesufGxPCT is optional. ~ 



I 

INTenSity? 



INTenSity TRACE, <value>, GRID, <value> 



The following enables remote control of the intensity, and changes 
the grid intensity level to 75 % : 

CMD$="INTS GRID, 75": CALL IBWRT ( SCOPE% , CMD$ ) 
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ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE 

RELATED COMMANDS 



INTERLEAVED , I LVD 

Command/ Query 



The INTERLEAVED command enables or disables random 
interleaved sampling (RIS) for timebase settings where both sin^e 
shot and RIS mode are available. See the specifications in the 
Operator's Manual. 

RIS is not available for seguence mode acguisitions. 

The response to the interleaved ? gueiy indicates whether the 
oscilloscope is in RIS mode. 



InterLeaVeD <mode> 

<mode> : = {on, off} 



InterLeaVeD? 



InterLeaVeD <mode> 

The following instructs the oscilloscope to use RIS mode: 

CMD$="ILVD ON": CALL IBWRT ( SCOPE% , CMD$ ) 



TIME_DIV, TRIG_M0DE, MEM0RY_SIZE 
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STATUS 

DESCRIPTION 

QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*IST? 

Query 

The * I ST ? (Individual STatus) query reads the current state of the 
IEEE 488.1-defined "ist" local message. The "ist" individual status 
message is the status bit sent during a parallel poll operation. 

*IST? 

*IST <value> 

<value> : = 0 or 1 

The following cause the contents of the IST bit to be read: 

CMD$="*IST?" : CALL IBWRT ( SCOPE% , CMD$ ) : 

CALL IBRD (SCOPE%, RSP$) : PRINT RSP$ 

Response message 

*IST 0 

*PRE 
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DISPLAY 



DESCRIPTION 

REMOTE ENABLE 



GO TO 
LOCAL 



Pause 



Continue 

Measurenent 



GO 



COMMAND SYNTAX 



EXAMPLE (GPIB) 



RELATED COMMANDS 



KEY 

Command 



The KEY command allows control of a program from the 
Waverunner front panel. Y ou can di^lay one or two lines of 13 
characters each in menus corresponding to the lower six menu 
buttons (soft keys). The top menu is reserved for G 0 TO LO CAL. 

You can also assign an executable file, such as AUTO EXEC.D SO, to a 
menu button. AUTO EXEC.D SO is a text file containing remote 
commands. If the file is present, the scope will read the file from the 
floppy or memory card and execute the remote commands contained 
in it. 

String text that you assign to these menus disappears when you 
switch to local, but reappears when you switch back to the remote 
state. Text is cleared at power-up, whenever you reset the 
oscilloscope, or when you assign an empty string to a location. Eor 
example: key 2 , ' ' . 

Pressing any one of the menu buttons in remote mode causes the 
User Request status Register (URR) and the URQ bit of the Event 
Status Register to be set. This can generate an SRQ , provided that 
the service request mechanism has been enabled. 



KEY <button>, '<string>', '<string>' 

KEY <button>,' <string> <string> <file_name>' 

<button> : = 1 to 5 

<string> : = Up to two 13-character strings (any ASCII code) 
<file_name> : = autoexec.dso 

The menus illustrated this page were created by issuing the following: 

CMD$="KEY 2, 'Pause'; KEY 3, 

'Continue', 'Measurement'; 

KEY 4, ' ', 'GO'": CALL IBWRT (SCOPE%, CMD$ ) 

URR 
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Remote Conbol Commands and Quaies 



DISPLAY 
DESCRIPTION 
COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 



LOGO 

Command/ Query 



The LO G 0 command controls the placement of the LeCroy logo at 
the top left comer of the time grid or the XY grid. 



LOGO <state> 

<state> : = {on, off} 



LOGO? 



LOGO <state> 



The following turns on the logo: 

CMD$="LOGO ON": CALL IBWRT ( SCOPE% , CMD$ ) 
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DESCRIPTION 



COMMAND SYNTAX 



MASK 

Command/ Query 

For PolyMask: 

MASK COLOR allow you to select two colors: one for the mask and 
one for displaying circles around sample points outside the mask. 

MASK DISP_FILLED selects whether the mask is filled or not. 
During testing, the mask will always be filled, regardless of the state 
of this selection. 

MASK DRAWTO diaws a line from the current position to a new 
position. It is a command only. 

MASK ERASE eiuses the current mask. 

MASK FILL fills the enclosed polygram from starting position. It is 
a command only. 

MASK MOVE T 0 Moves the cursor to a new position without 
drawing a line. It is a command only. 

SHOW_FAi L determines if errors inside or outside the mask should 
be circled. 

<destination>:MASK color <maskcolors>, <errorcolor> 

See the table of color choices under color command 

<destination>:MASK disp_filled <state> 

<state> : = {YES,NO} 

<destination>:MASK drawto <x_value>,<y_value> 

<x_value> : = 0 to 10 divisions (-4 to +4 divisions for XY Plot) 
<y_value> : = -4 to +4 divisions 

<destination>:MASK erase 

<destination>:MASK fill <x_value>,<y_value> 

<x_value> : = 0 to 10 divisions 
<y_value> : = -4 to +4 divisions 
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<destination>:MASK moveto <x_value>,<y_value> 

<x_value> : = 0 to 10 divisions 
<y_value> : = -4 to +4 divisions 

<destination>:SHOW_FAiL <state>,<coimt> 

<state> : = {OFF, INSIDE, OUTSIDE} 

<count> : = 1 to 1000 

<destination> : = {01, 02, 03, 04, TA, TB, TO, TD, TXY, PMXY} 

QUERY SYNTAX MASK7COLOR 

MASK7DISPEILLED 

EXAMPLE (GPIB) TA:MASK COLOR, BLUE, RED 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 

RESPONSE EORMAT 
EXAMPLE (GPIB) 



MEASURE_GATE, MGAT 

Command/ Query 



The MEASURE_GATE command is used to contrxrl whether or not 
the parameter measurement gate region (the region between the 
parameter cursors) is highlighted. Highlighting is performed by 
making the trace area outside the measurement gate region a neutral 
color. 

The response to the measure_gate ? query indicates whether or 
not the parameter measurement gate region is highlighted. 



Measure_GAXe <State> 
<state> : = {ON, OFF} 



Measure_GATe? 



Measure_GATe <State> 

The following highlights the measurement gate region: 

CMD$="MGAT ON": CALL IBWRT ( SCOPE% , CMD$ ) 
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ACQUISITION 



MEMORY_SIZE, MSIZ 

Command/ Query 



DE SCRIPTION 0 n most models where this command/ query is available, 

MEMORY_s I ZE allows Selection of the maximum memory length 
used for acquisition. See the specifications in the 0 perator's Manual. 



TIP: Reduce the number of data points for faster thmuglyiut 



The MEMORY_s I ZE ? query returns the current maximum memoiy 
length used to capture waveforms. When the optional suffix NUM is 
used with the query, the response will be returned in standard numeric 
format. 



COMMAND SYNTAX Memory_SIZe <size> 

<size> : = {500, le+3, ..., 2e+6, 4e+6, 8e+6}, for example, in 
standard numeric format. 

Or, alternatively: 

= {500, 1000, 2500, 5000, lOK, 25K, 50K, lOOK, 250K, 
50 OK, IM, 2.5M, 5M, IOM} 

However, values not absolutely identical to those listed immediately 
above will be recognized by the scope as numerical data (see the table 
under this heading in Chapter 1). For example, the scope will recognize 
1 . OM as 1 milhsample. But it will recognize l.OMA as 1 megasample. 

QUERY SYNTAX Memory_SIZe? [num] 



RESPONSE EORMAT Memory_SIZe <size> 



NOTE: The oscMosccgie will 
adapt to the closest valid <size> or 
numerical <value> according to 
available charmel memory. 



EXAMPLE The following will set the oscilloscope to acquire at most 10 000 data 

samples per sin^e-shot or RIS acquisition: 

CMD$="MSIZ lOK": CALL IBWRT (SCOPE%, CMD$ ) 
or CMD$="MSIZ lOe+3": CALL IBWRT (SCOPE%, CMD$ ) 

RELATED COMMANDS TDIV 
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Part Two: COMMANDS 



DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 



MESSAGE, MSG 

Command/ Query 



The ME s SAGE command displays a string of chaiuctens in the 
Message Field above the grid. The string can be up to 49 charucters in 
length. The string is displayed as long as the oscilloscope is in remote 
mode and no internal status message is generated. Turning the 
oscilloscope back to local mode deletes the message. After the next 
transition from local to remote the message will be redisplayed. The 
message is cleared at power-up, when the oscilloscope is reset, or if an 
empty string is sent (MSG " "). 

The ME SSAG E ? guery allows you to read the last message sent. 



MeSsaGe '<string>' 

<string> : = A string of a maximum of 49 characters 



MeSsaGe? 



MeSsaGe "<string>" 



The following causes the message Connect Probe ito appear in 
the message field: 

CMDS="MSG '*Connect Probe 1*"'; CALL 
IBWRT (SCOPE%, CMD$) 
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RemotB Conbol Commands and Quaies 



DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



MULTI_ZOOM, MZOM 

Command/ Query 

With MULTi_zooM ON, the horizontal magnification and 
positioning controls apply to all expanded traces simultaneously 
This command is useful if the contents of all expanded traces are to 
be examined at the same time. 



The MULTi_zooM? query indicates whether multiple zoom is 
enabled or not. 



NOTE: This command has the same effect as DUAL_ ZOt 


m. 




f 



Muiti_zooM <mode> 



<mode> : = {on, off} 

Multi_ZOoM? 

Muiti_zooM <mode> 

The following example turns the mirltiple zoom on: 

CMD$="MZOM ON": CALL IBWRT ( SCOPE% , CMD$ ) 
HOR_MAGNIFY, HOR_POSITION, DUAL_ZOOM 
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Part Two: COMMANDS 



ACQUISITION 

DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 

RESPONSE EORMAT 
AVAILABILITY 

EXAMPLE (GPIB) 



OFFSET, OFST 

Command/ Query 



The OFFSET command allows adjustment of the vertical offset of the 
specified input channel. 

The maximum ranges depend on the fixed sensitivity setting. See the 
Operator's Manual. 



If an out-of-range value is entered, the oscilloscope is set to the 
closest possible value and the VAB bit (bit 2) in the STB register is set. 



NOTE; The probe attenuation fyctoris not taken into accoui 
for adjusting the of^t 

ThesufGx Vis optional. 


nt 


The OFFSET? gueiy returns the DC offset value of the specified 


r 



channel. 



<channel> : OFf SeT <offset> 

<channel> : = {ci, C2, C3, C4} 

<offset> : = See the Operator's Manual for specifications. 



<channel> : OFf SeT? 



<channel> : OFf SeT <offset> 



<channel> : {C3, C4} only on four-channel oscilloscopes. 



The following sets the offset of Channel 2 to -3 V: 

CMD$="C2 :OFST -3V" : CALL IBWRT ( SCOPE% , CMD$ ) 



162 



I SSUE D : January 2002 



LTXXX-RCM-E Rev B 
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STATUS 

DESCRIPTION 

COMMAND SYNTAX 
QUERY SYNTAX 
RESPONSE EORMAT 
RELATED COMMANDS 



*OPC 

Command/ Query 



The *OPC (OPeiBtion Complete) command sets to true the 0 PC 
bit (bit 0) in the standard Event Status Register (ESR). This 
command has no other effect on the operation of the oscilloscope 
because the oscilloscope starts parsing a command or query only 
after it has completely process^ the previous command or query. 

The * OP c ? query alw^s responds with the ASCII character " 1" 
because the oscilloscope only responds to the query when the 
previous command has been entirely executed. 



*OPC 



*OPC? 



*OPC 1 



*WAI 
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MISCELLANEOUS 

DESCRIPTION 

QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 



*OPT? 

Query 

The * OP T ? query identifies oscilloscope options: installed firmware or 
hardware that is additional to the standard Wavenmner configuration. 
The response consists of a series of response fields listing all the 
installed options. 

*OPT? 



*OPT <option_l>, <option_2>, .., <option_N> 
<option_n> : = A three- or four-character ASCII string 




CMD$="*OPT?" : CALL IBWRT ( SCOPE% , CMD$ ) : 

CALL IBRD (SCOPE%, RSP$) : PRINT RSP$ 

If, for example, the waveform processing options EMM, G P02, JTA, 
MC04 and WAVA and are instiled, the response will be returned as: 

* EMM, GP02, JTA, MC04, WAVA 

Response message if no options are installed: 

*OPT 0 
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ADDITIONAL INFORMATION 



F 


Notation 


GP02 


Internal Printer/ Centronics Option 


HD02 


Hard Disk Option 


JTA 


Jitter and Timing Analysis Option 


MC02 


PC Card Slot 


EMM 


Extended Math and Measurement Option 


WAVA 


WaveAnalyzer Option (includes histograms) 
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Part Two: COMMANDS 



SAVE/ RECALL SETUP 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



PANEL_SETUP , PNSU 

Command/ Query 



The PANEL_SETUP command complements the * SAv or *rst 
commands. panel_setup allows you to archive panel setups in 
encoded form on external storage media 



0 nly setup data read by the p n s u ? query can be recalled into the 
oscilloscope. A panel setup error (see table on page 124) will be 
generated if the setup data block contains invalid data 



NOTE; The communication parameters (those moditied by 
corrtmands CFMT, CHDR, CHLP, CORD and WFSU) and 
mable registers associated with the status reporting system p 
(SRE, PRE, ESE, INE) an?not saved by this command. 






PaNel_SetUp <setup> 



<setup> : = A setup data block previously read by PNSU? 



PaNel_SetUp? 



PaNel_SetUp <setup> 



The following saves the oscilloscope's current panel setup in the file 
PANEL.SET: 

FILE$ = "PANEL.SET": CMD$="PNSU?" : 

CALL IBWRT (SCOPE%, CMD$) : CALL IBRDF ( SCOPE% , FILE$ ) 

Whereas the following recalls the front panel setup, stored previously 
in the file PANEL.SET, into the oscilloscope: 

CALL IBWRTF (SCOPE%, FILE$) 



*RCL, *SAV 
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CURSOR 

DESCRIPTION 

COMMAND SYNTAX 
RELATED COMMANDS 



PARAMETER_CLR, PACL 

Command 



The PARAMETER_CLR command clears all the current parameters 
from the five-line list used in the Custom and Pass/ Fail modes. 



NOTE; This command has the same effect as the command 
PASS_FAIL_C0NDITI0N, given without aigr arguments, r 



I 

PArameter_CLear 



PARAMETER_DELETE , PARAMETER_VALUE , 
PASS_FAIL_CONDITION 
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Part Two: COMMANDS 



CURSOR 



PARAMETER_CUSTOM, PACU 

Command/ Query 



DESCRIPTION The parameter_custom command controls the parametens that 

have customizable qualifiers and can also be used to assign any 
parameter for histograms. 



TIP: UsePAVA? to wad the measured value of a paiameter 
setup with PACU. 



COMMAND SYNTAX PArameter_Custom 

<line>, <parameter>, <qualifiei>[, <qualifier>, ...] 

<line> : = 1 to 5 

<parameter> : = {a parameter from the table below or any parameter 
listed in the PAVA? command} 

<qualifier> : = Measurement qualifierfs) ^edfic to each <param>. 
See below. 




<paiam> 


Definition 


<qualifiei> list ”1 


Customizable Parameters on all models 


DDLY 


delta del^ 


<sourcel>,<source2> 


PHASE 


phase difference 


<sourcel>,<edgel>,<levell>,<source2>,<edge2>,<level2>, 
<hysteresis>,<angular unit> 


Customizable Parameters with Extended Math Option 


DTLEV 


delta time at level 


<sourcel>,<slopel>,<levell>,<source2>,<slope2>,<level2>, 

<hysteresis> 


FLEV 


fall at level 


<source>, <high>, <low> 


RLEV 


rise at level 


<source>, <low>, <high> 


TLEV 


time at level 


<source>,<slope>,<level>,<hysteresis> 


1 Customizable Parameterswith WaveAnalyzer Option 


CALCx 


calculated parameter results 
) 


<sourcel>,<optional setup of sourcel>,<operator>,<source2> 


FWXX 


full width at xx % of max 


<source>, <threshold> 


PCTL 


percentile 


<source>, <threshold> 


XAPK 


X position at peak 


<source>,<rank> 
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RemotB Conbol Commands and Quaies 



QUERY SYNTAX 
RESPONSE EORMAT 
AVAILABILITY 

EXAMPLE 1 

Command Example: 

Query/ Re^onse Examples: 



* For Parameter Math option 



Where: 

<SOUrceN> : = {ci, C2, C3,C4,TA, tb, tc, td} 

<slopeN> : = {POS, NEG, FIRST} 

<edgeN> : = {pos, neg} 

<clockedge> : = {pos, neg, all} 

<levelN >, <low>, <high> : = 1 to 99 if level is specified in percent 
(PCT), or 

<levelN >, <low>, <high> : = Level in <sourceN > in the units of the 
waveform. 

<del^> : = -100 PCT to 100 PCT 

<freg> : = 10 to le9 Hz (Narrow Band center frequency) 

<hysteresis> : = 0.01 to 8 divisions 
<length> : = le-9 to 0.001 seconds 
<opeiator> : = {ADD, SUB, MUL, DIV}* 

<rank> : = 1 to 100 
<threshold> : = 0 to 100 percent 
<angularunit> = {pct, deg, rad} 

PArameter_CUstom? <line> 

PArameter_Custom <line>, <parameter>, <qualifier>[, <qualifier>, ...] 
<sourceN > : = {C3, C4} only on four-channel oscilloscopes. 

DTLEV 

PACU 2, DTLEV, Cl, POS, 34 5E-3 , C2 , NEG, -7 8 9E-3 
PACU? 2 returns: 

PACU 2, DTLEV, Cl, POS, 34 5E-3 , C2 , NEG, -7 8 9E-3 
PAVA? CUST2 returns: 

C2:PAVA CUST2,789 NS 
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EXAMPLE 2 

Command Example: 

Query/ Re^onse Examples: 



EXAMPLE 3 

Command Example: 

Query/ Re^onse Examples: 



DDLY 

PACU 2, DDLY, Cl, C2 

PACU? 2 returns: 

PACU 2, DDLY, Cl, C2 
PAVA? CUST2 returns: 

C2:PAVA CUST2,123 NS 

RLEV 

PACU 3, RLEV, Cl, 2PCT, 67PCT 
PACU? 3 returns: 

PACU 3, RLEV, Cl, 2PCT, 67PCT 
PAVA? CUST3 returns: 

C1:PAVA CUST3,23 MS 



EXAMPLE 4 



FLEV 



Command Example: 

Query/ Re^onse Examples: 



PACU 3, FLEV, Cl, 345E-3, 122E-3 
PACU? 3 returns: 

PACU 3, FLEV, Cl, 345E-3, 122E-3 
PAVA? CUST3 returns: 

C1:PAVA CUST3,23 MS 



EXAMPLE 5(PaiametjerMath) 

Command Example: 

Query/ Re^onse Examples: 



CALCx 

PACU 5, CALCl, AMPL, C3, DIV, AMPL, C2 
PACU? 5 returns: 

PACU 5, CALCl, AMPL, C3, DIV, AMPL, C2 
PAVA? CUST5 returns: 

C2:PAVA CUSTl, 4 . 884, OK 



RELATED COMMANDS parameter_delete, parameter_value, 

PAS S_FAI L_COND I T I ON 
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RemotB Conbol Commands and Quaies 



CURSOR 

DESCRIPTION 



COMMAND SYNTAX 

EXAMPLE (GPIB) 
RELATED COMMANDS 



PARAMETER_DELETE, PADL 

Command 



The PARAMETER_DELETE command deletes a parameter at a 
specified line from the list of parameters used in the Custom and 
Pass/ Fail modes. 



Notation 


1 


line 1 


of Custom or Pass/ Fail displ^ 


1 ^ 


line 2 


of Custom or Pass/ Fail displ^ 


3 


line 3 


of Custom or Pass/ Fail displ^ 


4 


lined 


of Custom or Pass/ Fail displ^ 


5 


line 5 


of Custom or Pass/ Fail displ^ 



PArameter_DeLete <line> 
<line> : = {1, 2, 3, 4, 5} 



NOTE: This command has the same effect as the command 
PASS_FAIL_C0NDITI0N <line>, given without any further 
arguments. 



The following deletes the third test condition in the list: 

CMD$="PADL 3": CALL IBWRT ( SCOPE% , CMD$ ) 






PARAMETER_CLR, PARAMETER_VALUE , 
PAS S_FAI L_COND I T I ON 
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Part Two: COMMANDS 



CURSOR 

DESCRIPTION 



QUERY SYNTAX 

EXAMPLE (GPIB) 

RESPONSE EORMAT 
RELATED COMMANDS 



PARAMETER_STATISTICS?, PAST? 

Query 



The PARAMETER_s TAT I s T I c s ? queiy returns the current 
values of statistics for the specified pulse parameter mode and the 
result type, for all five lines of the pulse parameters display. 



1 Notation 


1 AVG 


average 


GUST 


custom parameters 


HIGH 


highest value 


HPAR 


horizontal standard parameters 1 


LOW 


lowest value ’ 


PARAM 


parameter definition for each line 


SIGMA 


sigma (standard deviation) 


1 sweep s number of sweeps accumulated for each line 


1 vpar 


vertical standard parameters 



PArameter_STatistics ? <mode>, <result> 

<mode> : = {oust, hpar, vpar} 

<result> : = {avg, low, high, sigma, sweeps, param} 

NOTE; If keyword PARAM is spedBed, the query returns the 
list of the Eve pairs <parameter_name>,<source>. 

The following query reads the average values of the five 
standard verticd parameters: 

CMD$="PAST? vpar, AVG": CALL 
IBWRT (SC0PE%, CMD$) : 

CALL IBRD (SC0PE%, RD$) : PRINT RD% 

PAST VPAR, AVG, I3V, 26V, 47V, IV, OV 



parameter_value 
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CURSOR PARAMETER_VALUE?, PAVA? 

Query 

DESCRIPTION The parameter_value query returns the current value orvalues 

of the pulse waveform parameter or parameters and mask tests for 
the specified trace. Traces do not ne^ to be displayed or selected to 
obtain the values measured by the pulse parameters or mask tests. 



Available on All Models 



ALL 


aU parameters 


DUTY 


duty cycle 


PER 


period 


AMPL 


amplitude 


FALL 


faUtime 


PHASE 


phase difference 


AREA 


area 






PNTS 


points 


BASE 1 


base 


FREQ 


frequency 


RISE 


risetime 


CMEAN 


mean for cyclic 
waveform 


MAX 


maximum 


RISE28 


rise 20 to 80 % 


CRMS 


root mean square for 
cyclic part of waveform 


MEAN 


mean 


RMS 


root mean scpiare 


CYCL 


cycles 


MIN 1 


niinimum 


SDEV 


standard deviation 


DLY 


del^ 


OVSN 1 


negative overshoot 


TOP 


top 


DUR 


duration of acquisition 


i 

lovsp 


positive overshoot 


1 

WID 1 


width 



Custom Parameters Deeined using PARAMETER CUSTOM Command* 



^ CUSTl 


CUST2 


CUST3 


CUST4 1 



* The numbers in the terms CUSTl, CUST2, GUSTS, CUST4 and GUSTS refer to the line numbers of the selected custom 
parameters. 
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Available with Extended Math or Wave Analyzer Option 


AVG 


average of distribution 


HRMS 


histogram rms value 


PKS 


number of peaks 


CMEDI 


median for cyclic 
waveform 


HTOP 


histogram top value 


RANGE 


range of distribution 


CSDEV 


standard deviation for 
cyclic part of waveform 


LAST 


last point 


SIGMA 


sigma of distribution 


FRST 


fust point 


MAXP 


maximum population 


TOTP 


total population 


HIGH 


high of histogram 


MED I 


median value 






HMEDI 


median of a histogram 


MODE 


mode of distribution 







Parameter Computation States 1 


AV 


averaged over several (up to 100) periods 


OF 


signal partially in overflow 


GT 


greater than given value 


OK 


deemed to be determined without problem 


IV 


invalid value (insufficient data provided) 


OU 


signal partially in overflow and imderflow 


LT 


less than given value 


PT 


window has been period truncated 


NP 


no pulse waveform 


UF 


signal partially in imderflow 


1 MaskTest Names 


ALL_IN 


all points of waveform inside 
mask (TRUE = 1, FALSE = 0) 


SOME_ 


IN some points of waveform inside mask 

(TRUE = 1, FALSE = 0) 


ALL_OUT 


all points of waveform outside 
mask (TRUE = 1, FALSE = 0) 


SOME_ 


OUT some points of waveform outside mask 

(TRUE = 1, FALSE = 0) 



QUERY SYNTAX <trace> : PArameter_VAlue? [<parameter>,...,<parameter>] 

<trace> : = {TA, TB, TC, TD, Cl, C2, C3,C4} 

<parameter> : = See table of parameters. 

Alternative forms of query for mask tests: 
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RESPONSE EORMAT 



AVAILABILITY 
EXAMPLE (GPIB) 

RELATED COMMANDS 



<trace> : PArameter_VAiue? <mask_test>, <mask> 
<mask_test> : = {all_in, some_in, all_out, some_out} 
<mask> : = {ta, tb, tc, td} 



<trace> : PArameter_VAiue <parameter>, <value>, 
<state> <parameter>, <value>, <state>] 

<value> : = A decimal numeric value 

<state> : = {ok, av, pt, iv, np, gt, lt, of, uf, ou} 



NOTE: If <paiametei> isnotsped&ed, oris equal to ALL, all 
standard voltage and time paian^ms are returned followed by 
theirvalues and states. 



<trace> : {C3, C4} only available on four-channel oscilloscopes. 






The following query reads the lisetime of Trace B (TB): 

CMD$="TB:PAVA? RISE"; CALL IBWRT (SCOPE%, CMD$ ) : 
CALL IBRD (SCOPE%, RD$) : PRINT RD$ 

Response message: 

TB:PAVA RI SE , 3 . 6E-9S , OK 



CURSOR_MEASURE, CURSOR_SET, PARAMETER_CUSTOM, 
PARAMETER_S TAT I S T I C S 
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CURSOR 

DESCRIPTION 



COMMAND SYNTAX 



PASS_FAIL_CONDITION, PFCO 

Command/ Query 



The PASS_FAiL_coNDiTiON command adds a Pass/ Fail test 
condition or a custom parameter at the specified line on the Pass/ Fail 
or Custom Parameter display. 

The PAS s_FAi L_C0ND I T I ON ? query indicates the current 
Pass/ Fail test setup or the current selection of custom parameters at 
the ^ecified line. 



NOTE; Up to Bve test conditions (or custom parameters) can be 
specitied at Sve different drsplaiy lines on the saem. The 
command PASS_FAiL_ condi tion deals with one line — 

^ a time. ~ 










Notation 


1 GT 


1 greater than 




LT lower than 



Pass_Fail_Condition 

[<line>, <trace>, <parameter>[, <rel_op> [,<ref_value>]]] 

<line> : = {1,2, 3, 4, 5} 

<trace> : = {ta, TB, to, TD, Cl, C2, C3, 04} 
<parameter> : = See tables of parameters on pages 168 and 173. 
<rel_op> : = {gt, lt} 

<ref_value> : = -lel5 to +lel5 

NOTE; The PFCO command with no arguments (Le. "pfcO") 
deletes all conditions. The PECO command with a single 

argument (i.e. "pfco <line>" ) deletes the condition at 

<line>. — 

Alternative form of command for mask tests: 

Pass_Faii_condition [<lme>, <trace>, <mask_test>, <mask>] 

<mask_test> : = {all_in, some_in, all_out, some_out} 
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QUERY SYNTAX 
RESPONSE EORMAT 

AVAILABILITY 
EXAMPLE (GPIB) 

RELATED COMMANDS 



<mask> : = {ta, tb, tc, td} 

PFCO? <line> 

PFCO <line>, <trace>, <parameter>, <rel_op>, <ref_value> 
Alternative form of response for mask tests: 

PFCO <line> , <trace> , <mask_test> , <mask> 

<trace> : = {C3, C4} only on four-channel oscilloscopes. 

The following sets the first test condition in the list to be "frequency on 
Channel 1 lower than 10 kHz": 

CMD$="PFCO 1, Cl, FREQ, LT, 10000" : 

CALL IBWRT (SCOPE%, CMD$) 



CURSOR_MEASURE, CURSOR_SET, PASS_FAIL_COUNTER, 
PASS_FAIL_DO, PASS_FAIL_MASK, PARAMETER_VALUE 
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CURSOR 

DESCRIPTION 

COMMAND SYNTAX 
QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 
RELATED COMMANDS 



PASS_FAIL_COUNTER, PFCT 

Command/ Query 

The PASS_FAiL_couNTER command resets the Passed/ Failed 
acquisrtrons counters. The pass_fail_counter? query 
returns the current counts. 



Pass_Fail_CounTer 



Pass_Fail_CounTer ? 



Pass_Faii_CounTer <pass/fail>, <value>, OF, <value> 
<value> : = 0 to 999999 
<pass/fail> : = {pass, fail} 

The following query reads the counters: 

CMD$="PFCT?" : CALL IBWRT (SCOPE%, CMD$ ) 

Response message: 

PFCT PASS, 8, OF, 9 

CURSOR_MEASURE, CURSOR_SET, PASS_FAIL_DO, 
PASS_FAIL_MASK, PARAMETER_VALUE 
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CURSOR 



PASS_FAIL_DO, PFDO 

Command/ Query 



DESCRIPTION The pass_fail_do command defines the desired outcome and the 

actions that have to be performed by the oscilloscope after a Pass/ Fail 
test. The pas s_fai l_do ? query indicates which actions are 
currently selected. 



Notation 


beep 


emit a beep 


puls 


emit a pulse on the CAL connector 


scdp 


make a hard copy 


STO 


store in memory or on storage media 


stop 


stop acquisition 



COMMAND SYNTAX Pass_Fail_DO [<outcome>[, <act>[, <act>...]]] 

<outcome> : = {pass, fail} 

<act> : = {stop, scdp, sto} 

NOTE: 

BEEP is accepted only on models equipped with the CLBZ hardware option 
PULS is acx:epted only on nxtdds equipped with the CKIO sofbmre option 
PFDO without arguments deletes all actions. 

STO performs the store operation as described in the Operator's Manual 
After ev^ pass or fail detected, the oscilloscope sets the INR bit 12 



QUERY SYNTAX Pass_Fail_DO? 
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RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



Pass_Faii_DO [<pass_fail>[, <act>[, <act>...]]] 



This following forces the oscilloscope to stop acquiring when the test 
passes: 

CMD$="PFDO PASS, STOP": CALL IBWRT ( SCOPE% , CMD$ ) 



BUZZER, CURSOR_MEASURE, CURSOR_SET, INR, 
PARAMETER_VALUE, PASS_FAIL_COUNTER, 
PASS_FAIL_MASK 



180 



I SSUE D : January 2002 



LTXXX-RCM-E Rev B 




RemotB Conbol Commands and Quaies 



CURSOR 

DESCRIPTION 
COMMAND SYNTAX 



AVAILABILITY 
EXAMPLE (GPIB) 

RELATED COMMANDS 



PASS_FAIL_MASK, PFMS 

Command 



The PASS_FAiL_MASK command generates a tolerance mask around 
a chosen trace and stores the mask in the selected memory. 



Pass_Faii_MaSk [<trace>[, <htol>[, <vtol>[, <mask>]]]] 

<trace> : = {ta, tb, tc, td, mi, m2, m 3, M4, Cl, C2, C3, 
C4} 

<htol> : = 0.0 to 5.0 
<vtol> : = 0.0 to 4.0 
<mask> : = {mi, m2, m3, m4} 



NOTE: if any aigiunents aw missing, the pwidous settings mil 
be used. 



The alternative form of command: 

Pass_Fail_MaSk INVT [, <mask>] 

inverts the mask in the selected mask memory. If <mask> is missing, 
M4 is implied. 



<trace> : = {C3, C4} only on four-channel oscilloscopes. 

The following generates a tolerance mask aroimd the Channel 1 trace 
and stores it in M2: 

CMD$="PASS_FAIL_MASK Cl, 0.2, 0.3, M2": 

CALL IBWRT (SCOPE%, CMD$) 



PASS_FAIL_DO, PARAMETER_VALUE 
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Part Two: COMMANDS 



CURSOR 

DESCRIPTION 
QUERY SYNTAX 

RESPONSE EORMAT 

EXAMPLE (GPIB) 

RELATED COMMANDS 



PASS_FAIL_STATUS?, PFST? 

Query 



The PASS_FAiL_STATUS queiy returns the status of the Pass/ Fail 
test for a given line number. 

Pass_Fail_STatus? <line> 

<line> : = {1, 2, 3, 4, 5} 



Pass_Fail_STatus <line>, <state> 

<state> : = {true, false} 

The following queries the state of the Pass/ Fail test condition 
specified for line 3. 

CMDS="PFST? 3": CALL IBWRT ( SCOPE% , CMD$ ) 



PAS S_FAI L_DO , PAS S_FAI L_COND I T I ON , 
PARAMETER_VALUE 
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CURSOR PER_CURSOR_SET, PECS 

Command/ Query 

DESCRIPTION The per_cursor_set command allows you to position any one of 

the six independent cursors at a given screen location. The position of 
the cursor can be modified or queried even if the cursor is not currently 
displayed on the screen. 

The PER_cuRSOR_SET ? query indicates the current position of the 
cursor or cursors. 

The vertical cursor positions are the same as those controlled by the 
CURS0R_SET command. 



r Notation 


habs 


horizontal absolute 


VABS 


vertical absolute 


HDIF 


horizontal difference 


VDIF 


vertical difference 


HREF 


horizontal reference 


VREF 


vertical reference 



COMMAND SYNTAX <trace> : PEr_Cursor_Set <cursor>, 

<position>[, <cursor>, <position>, ..., <cursor>,<position> 

trace> : = {ta, tb, tc, td, ci, C2, C3,C4} 

<cursor> : = {habs, hdif, href, vabs, vdif, vref} 

<position> : = 0 to 10 DIV (horizontal), -29.5 to 29.5 D IV (vertical) 

NOTE; diameters aw gwiqtedin pairs. TheOrstof the pair names the variable tobemodiSed, while 
the second gives the new value to be assigned, ^iis can be in any order and limited to those variables to 
be changed. 

ThesufBxDiv is optional. 

If <cursor> is not spedBed, ALL will be assumed. If the position of a cursor carmot be determine d in 



a particular situation, its position will be indicated as undef. 


— 




r 



QUERY SYNTAX <tiace> : PEr_Cursor_Set? <cursoi>[, <cursor, ..., <cursoi>] 

<cursor> : = {habs, hdif, href, vabs, vdif, vref, all} 
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Part Two: COMMANDS 



RESPONSE EORMAT 

AVAILABILITY 
EXAMPLE (GPIB) 

RELATED COMMANDS 



PEr_Cursor_Set <cuTSor>, <position>[, <cursor>,<position>, 
<cursoi>, <position> 



<trace> : = {C3, C4} only available on four-channel oscilloscopes. 



The following positions the HREF and HDIF cursors at -t-2.6 DIV and 
-i7.4 D IV respectively, using Channel 2 as a reference: 

CMD$="C2 :PECS HREF, 2. 6 DIV, HDIF, 7 . 4DIV" 



CURSOR_MEASURE, CURSOR_SET, PERSIST, 
PER_CURSOR_VALUE 



m 
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CURSOR PER_CURSOR_VALUE?, PECV? 

Query 



DESCRIPTION The per_cursor_value ? query returns the values measured by 

the cursors specified below while in Persistence mode. 



Notation 


HABS 


horizontal absolute 


VABS 


vertical absolute 


HREL 


horizontal relative 


VREL 


vertical relative 



QUERY SYNTAX <trace> : PEr_Cursor_vaiue? <cursor>[, <cursoi>, <cursoi>] 

<trace> : = {ta, tb, tc, td, ci, C2, C3,C4} 

<cursor> : = {habs, hrel, vabs, vrel, all} 

Note If <Qirscr> isnctqHified ALL vaUbeassurred 

RESPONSE EORMAT <trace> : PEr_Cursor_Value <cursor>, 

<value>[, <cursor>, <value>, <cursor>, <value>] 

AVAILABILITY <trace> : = {C3, C4} only on four-channel oscilloscopes. 

EXAMPLE (GPIB) The following returns the value measured with the vertical relative 

cursor on Channel 1: 

CMD$="C1 :PECV? VREL"; CALL IBWRT (SCOPE%, CMD$ ) : 
CALL IBRD (SCOPE%, RSP$) : PRINT RSP$ 

Response message: 

Cl : PECV VREL, 56 MV 

RELATED COMMANDS CURS0R_MEASURE, PERSIST, PER_CURSOR_SET 
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Part Two: COMMANDS 



DISPLAY 
DESCRIPTION 
COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



PERSIST, PERS 

Command/ Query 

The PERS 1ST command enables or disables the persistence display 
mode. 

PERS i St <mode> 

<mode> : = {on, off} 

PERSist? 



PERS 1st <mode> 

The following turns the persistence di^lay 0 N : 

CMD$="PERS ON": CALL IBWRT ( SCOPE% , CMD$ ) 

PERSIST_COLOR, PERS I ST_LAST , PERSIST_SAT, 
PERSIST_SETUP 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



PERSIST_COLOR, PECL 

Command/ Query 



The PERS I ST_C0L0R command controls the color rendering 
method of persistence traces. 

The response to the pers i st_color? query indicates the color 
rendering method, Analog Persistence^'^ or Color G raded Persistence. 

See the 0 perator's Manual. 



PErsist_CoLor <State> 

<state> : = {analog, color_graded} 



PErsist_CoLor ? 



PErsist_CoLor <State> 



The following sets the persistence trace color to an intensity-graded 
range of the selected trace color: 

CMD$="PECL ANALOG": CALL IBWRT ( SCOPE% , CMD$ ) 



COLOR, COLOR_SCHEME, PERSIST, PERSIST_LAST, 
PERSIST_SAT, PERSIST_SETUP 
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Part Two: COMMANDS 



DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



PERSIST_LAST, PELT 

Command/ Query 



The PERS I ST_LAST command controls whether or not the last 
trace drawn in a persistence data map is shown. 

The response to the pers i st_last ? query indicates whether 
the last trace is shown within its persistence data map. 



PErsist_LasT <State> 

<state> : = {on, off} 



PErsist_LasT? 



PErsist_LasT <State> 



The following ensures the last trace is visible within its persistence 
data map: 

CMD$="PELT ON": CALL IBWRT ( SCOPE% , CMD$ ) 



PERSIST, PERSIST_COLOR, PERSIST_SAT, 
PERSIST_SETUP 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 

RESPONSE EORMAT 
AVAILABILITY 

EXAMPLE (GPIB) 
RELATED COMMANDS 



PERSIST_SAT, PESA 

Command/ Query 



The PERS I ST_SAT command sets the level at which the color 
spectrum of the persistence display is saturated. The level is specified 
in terms of percentage (PCT) of the total persistence data map 
population. A level of 100 PCT corresponds to the color spectrum 
being spread across the entire depth of the persistence data map. At 
lower values, the spectrum will saturate (bri^test value) at the 
specified percentage value. The PCT is optional. 

The response to thePERSiST_SAT? query indicates the saturation 
level of the persistence data maps. 



PErsist_SAt <trace>, <value> [<trace>, <value>] 
<trace> : = { ci, C2, C3, C4, ta, tb, tc, td} 
<value> : = 0 to 100 PCT 



NOTE: The suTBx PCT is optional. 


— 




V 



PErsist_SAt? 



p E r s i s t_s At <ttace> , <value> 



<trace> : = {C3, C4} only on four-channel oscilloscopes. 



The following sets the saturation level of the persistence data map for 
channel 3 to be 60 % — 60 % of the data points will be displayed with 
the color spectrum, with the remaining 40 % saturated in the brightest 
color: 

CMD$="PESA C3,60": CALL IBWRT (SCOPE%, CMD$) 



PERSIST, PERSIST_COLOR, PERS I ST_PERS , 
PERSIST_SETUP 
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Part Two: COMMANDS 



DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



PERSIST_SETUP, PESU 

Command/ Query 



The PERS I ST_SETUP command selects the persistence duiution of 
the display, in seconds, in persistence mode. In addition, the 
persistence can be set either to all traces or only the top two on the 
screen. 

ThePERSiST_SETUP? queiy indicates the Current status of the 
persistence. 



PErsist_SetUp <ttme>, <mode> 

<time> : = {O . 5, 1, 2, 5, 10, 20, infinite} 
<mode> : = {TOP2, all} 



PErsist_SetUp? 

PErsist_SetUp <ttme>, <mode> 

The following sets the variable persistence at 10 seconds on the top two 
traces: 

CMD$="PESU 20,TOP2": CALL IBWRT ( SCOPE% , CMD$ ) 



PERSIST, PERSIST_COLOR, PERS I ST_PERS , 
PERSIST_SAT 
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STATUS 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



*PRE 

Command/ Query 



The *PRE command sets the PaRallel poll Enable register (PRE). The 
lowest eight bits of the Parallel Poll Register (PPR) are composed of the 
STB bits. *PRE allows you to specify which bit(s) of the paullel poll 
register will affect the 'ist' individual status bit. 

The *PRE ? query reads the contents of the PRE register. The 
response is a decimal number which corresponds to the binary sum of 
the register bits. 



PRE <value> 

<value> : = 0 to 65 535 



*PRE? 



*PRE <value> 



The following will cause the 'ist' status bit to become 1 as soon as the 
MAY bit (bit 4 of STB, i.e. decimal 16) is set, and yields the pre value 
16: 

CMD$="*PRE 16": CALL IBWRT ( SCOPE% , CMD$ ) 



*IST 
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Part Two: COMMANDS 



PROBES 

DESCRIPTION 

QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 
RELATED COMMANDS 



PROBE_CAL?, PRCA? 

Query 



The PROBE_CAL ? query performs a complete auto-calrbration 
of a current probe connected to your Wavenmner oscilloscope. 
At the end of this calibration, the response indicates how the 
calibration has terminated, and the oscilloscope then returns to 
the state it was in prior to the query. 



<channel> : probe_cal? 



PROBE_CAL <diagnostics> 
<diagnostics> : = 0 or 1 
0 = Calibration successful 



The following forces a self-calibration: 

CMD$="PROBE_CAL?" : CALL 
IBWRT (SCOPE%, CMD$) : 

CALL IBRD (SCOPE%, RD$) : PRINT RD$ 

Response message (if no failure): probe_cal o 



AUTO_CALIBRATE, *CAL?, PROBE_DEGAUSS ? 
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PROBES 

DESCRIPTION 

QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 
RELATED COMMANDS 



PROBE_DEGAUSS?, PRDG? 

Query 



The PROBE_DEGAUSS ? queiy performs the automatic degaussing 
of the current probe connected to your Waverunner oscilloscope. This 
eliminates core saturation by use of a backing current and ^plication 
of an alternating field, reduced in amplitude over time from an initial 
high value. After the degaussing, a probe calibration is performed. 



<channel> : probe_degauss? 



PROBE_DEGAUSS <diagnostics> 

<diagnostics> : = 0 or 1 
0 = Degaussing and calibration successful 

(N otie: If coupling is not D C, probe calibration will not be performed, 
and the <diagnostics> response will be 1.) 



The following degausses and calibrates the connected probe: 

CMD$="PROBE_DEGAUSS?" : CALL 
IBWRT (SCOPE%, CMD$) : 

CALL IBRD (SCOPE%, RD$) : PRINT RD$ 

Response message (if no failure): 

PROBE_DEGAUSS 0 



PROBE_CAL?, PROBE_NAME? 
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Part Two: COMMANDS 



PROBES 

DESCRIPTION 

QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 
RELATED COMMANDS 



PROBE_NAME?, PRNA? 

Query 



The PROBE_NAME ? queiy returns the name of a probe connected to 
your Waveruriner oscilloscope. Passive probes are identified by their 
attenuation factor. 



<channel> : probe_name? 



PROBE_NAME <name> 

<diagnostics> : = 0 or 1 
0 = successful 

The following obtains an identification of the connected probe: 

CMD$="PROBE_NAME?" ; CALL IBWRT ( SCOPE% , CMD$ ) : 
CALL IBRD (SCOPE%, RD$) : PRINT RD$ 



PROBE_CAL?, PROBE_DEGAUSS? 
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SAVE/ RECALL SETUP 
DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



*RCL 

Command 



The *RCL command sets the state of your Waverunner 
oscilloscope, using one of the five non-volatile panel setups, by 
recalling the complete front panel setup of the oscilloscope. Panel 
setup 0 corresponds to the default panel setup. 

The *RCL command produces an effect the opposite of the *SAV 
command. 

If the desired panel setup is not acceptable, the Execution error 
status Register (EXR) is set and the EXE bit of the standard Event 
Status Register (E SR) is set. 



*RCL <panel_setup> 
<panel_setup> : = 0 to 4 



The following recalls your Waverunner oscilloscope setup previously 
stored in panel setup 3: 

CMD$="*RCL 3": CALL IBWRT ( SCOPE% , CMD$ ) 



PANEL_SETUP, *SAV, EXR 
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MISCELLANEOUS REAR_OUTPUT, ROUT 

Command/ Query 

DE SCRIPTION The re ar_outp ut command is used to set the type of signal put out 

at the Waverunner rear panel BNC connector. The rear_output ? 
Query returns the current mode of the connector. 

COMMAND SYNTAX Rear_0UTput <mode>[, <level>[, <rate>]] 

<mode> : = {OFF, PF, TRIG, TRDY, PULSE} 

QUERY SYNTAX Rear_OUTput? 

RESPONSE EORMAT Rear_0UTput <mode>,<level>[,<rate>] 

EXAMPLE (GPIB) The following turns off the BNC rear output: 

CMD$="ROUT OFF"; 

CALL IBWRT (SCOPE%, CMD$) 



RELATED COMMANDS PASS_FAIL_DO, CAL_OUTPUT 

ADDITIONAL INEORMATION 





Notation 


OFF |i 


Turns off rear output 


PF 1 


PASS/ FAIL mode 


PULSE 


Provides a srn^e pulse 


TRIG [ 


Trigger Out mode 


TRDY 1 


Trigger is ready for a new acquisition 
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WA VE FORM TRANSFER 

DESCRIPTION 

COMMAND SYNTAX 

AVAILABILITY 
EXAMPLE (GPIB) 

RELATED COMMANDS 



RECALL, REC 

Command 



The RECALL command recalls a waveform file from the current 
directory on mass storage into any or all of the internal memories Ml 



to M4. 


NOTE; only wavefonns stored in BINARY format can be 
recalled. 







7 



<memory> : RECall DISK, <device>, FILE, '<filename>' 
<memory> : = {mi, m2, m3, m4, all} 

<device> : = {card, flpy, hdd} 

<filename> : = An alphanumeric string of up to ei^t characters, 
followed by a dot and an extension of up to three digits. 



<device> : card only available with Memory Card option installed. 

<device> : hdd only available with removable Hard Disk option 
installed. 



The following recalls a waveform file called "SCl.OOl" from the 
memory card into Memory Ml: 

CMD$ = "M1:REC DISK, CARD, FILE, 'SCI . 001"' : CALL 
IBWRT (SCOPE%, CMD$) 



STORE, INR? 
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Part Two: COMMANDS 



SAVE/ RECALL SETUP 
DESCRIPTION 
COMMAND SYNTAX 

AVAILABILITY 
EXAMPLE (GPIB) 

RELATED COMMANDS 



RECALL_PANEL, RCPN 

Command 



The RECALL_PANEL command recalls a front panel setup from the 
current directoiy on mass storage. 



ReCaii_PaNei DISK, <device>, FILE, '<filename>' 
<device> : = {card, flpy, hdd} 

<filename> : = A string of up to eight characters with the extension 

• PNL. 



<device> : card only available with Memory Card option installed. 

<device> : hdd only available with removable Hard Disk option 
installed. 



The following recalls the front panel setup from file P012.PNL on the 
floppy disk: 

CMD$ = "RCPN disk, flpy, FILE, 'P012 .PNL'" : 

CALL IBWRT (SCOPE%, CMD$) 



PANEL_SETUP, *SAV, STORE_PANEL, *RCL 



198 



I SSUE D : January 2002 



LTXXX-RCM-E Rev B 




Remote Conbol Commands and Quaies 



SAVE/ RECALL SETUP 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



*RST 

Command 



The *RST command initiates a device reset. *rst sets all eight traces 
to the G ND line and recalls the default setup. 



*RST 

The following resets the oscilloscope: 

CMD$="*RST": CALL IBWRT ( SCOPE% , CMD$ ) 
*CAL, *RCL 
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Part Two: COMMANDS 



ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 



QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE 



SAMPLE_CLOCK, SCLK 

Command/ Query 



The SAMPLE_CLOCK command allows you to control an external 
timebase. Set the number of data points that will be acquired when your 
Waverunner oscilloscope is using the external clock. When the optional 
suffix NUM is used with the query, the response will be returned in 
standard numeric format. 



Sampie_CLocK <state>[, <recordlength>][, <coupling>] 

<State> : = {INT, ECL, LVO, TTL} 

<recordlength> : = {lOe+3, 10 . Oe+3, lle+3... }, for example, 
in standard numeric format. 

Or, alternatively: 

= {50, 100, 200, 500, IK, 2K, 5K, lOK, 20K, 50K, lOOK, 
2 0 OK, 50 OK, IM, 2M} 

However, values not absolutely identical to those listed immediately 
above will be recognized by the scope as numerical data (see the table 
under this heading in Chapter 1). For example, the scope will recognize 
1 . OM as 1 millisample. But it will recognize i . oma as 1 megasample. 

<coupling> : = {dim or 05 0} 



TIP: You cannot have the lecoid length larger than the maximum 
available memory of your osciUoscope. Whverurmerwill adapt to 
the closest valid <recordlength>. See the Operator's Marrual for 
maximums. 




Sample_CLocK? [NUM] 



Sampie_CLocK <state> , <recordlength> 

The following sets the oscilloscope to use the external clock with 1000- 
data-point records. 

CMDS="SCLK ECL, 1000": CALL IBWRT ( SCOPE% , CMD$ ) 
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SAVE/ RECALL SETUP 
DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



*SAV 

Command 



The * s Av command stores the current state of your Waverunner 
oscilloscope in non-volatile internal memory. The *SAV command 
stores the complete front panel setup of the oscilloscope at the time 
the command is issued. 



NOTE: Neither communication paian^eis (those modMedby 
the commands C0MM_F0RMAT, comm_header, comm_help, 
C0MM_0RDER and WAVEFORM_SETUP), nor enable registers of 
the status reporting system (*sre, *pre, *ese, ine), aresaved 
when *SAV is used. HZ 



*SAV <panel_setup> 
<panel_setup> : = 1 to 4 



The following saves the current Waverunner oscilloscope setup in 
panel setup 3: 

CMD$="*SAV 3": CALL IBWRT ( SCOPE% , CMD$ ) 



PANEL_SETUP, *RCL 
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Part Two: COMMANDS 



HARD COPY 



SCREEN_DUMP , SCDP 

Command/ Query 



DESCRIPTION 



COMMAND SYNTAX 
QUERY SYNTAX 
RESPONSE EORMAT 



EXAMPLE (GPIB) 



The SCREEN_DUMP command causes the oscilloscope to dump the 
screen contents onto the hardcopy device. This command will halt 
your Waverunner oscilloscope's activities. 

The time/ date stamp which appears on the piint-out corre^onds to 
the time at which the command was execute. 



SCreen_DumP 



SCreen_DumP? 



SCreen_DumP <StatUS> 

<status> : = {off} 

The following initiates a screen dump: 

CMD$="SCDP": CALL IBWRT ( SCOPE% , CMD$ ) 



RELATED COMMANDS 



INR, HARDCOPY_SETUP, HARDCOPY_TRANSMIT 
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DISPLAY SCREEN_SAVE, SCSV 

Command/ Query 



DESCRIPTION 


The SCREEN_SAVE command controls the automatic Screen Saver, 
which automatically shuts down the internal color monitor after a 
preset time. 

The response to the screen_save ? query indicates whether the 
automatic screen saver feature is on or off. 




NOTE; When the screen save is in eflect, the osciUoscope is still 




hilly functional. 


L 


COMMAND SYNTAX 


screen_SaVe <enabled> 


r 




<enabled> : = {yes, no} 




QUERY SYNTAX 


SCreen_SaVe? 




RESPONSE EORMAT 


SCreen_SaVe <State> 




EXAMPLE (GPIB) 


The following enables the automatic screen saver 






CMD$="SCSV YES": CALL IBWRT ( SCOPE% , CMD$ ) 
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Part Two: COMMANDS 



DISPLAY 



SELECT, SEL 

Command/ Query 



DESCRIPTION 



COMMAND SYNTAX 



QUERY SYNTAX 
RESPONSE EORMAT 



EXAMPLE (GPIB) 



The SELECT command selects the specified truce for manual display 
control. An environment error (see ti)le on page 124) is generated if 
the specified truce is not displayed. 

The SELECT ? query returns the selection status of the specified 
truce. 



<truce> : SELect 
<truce> : = {ta, tb, tc, td} 



<truce> : SELect? 



<truce> : SELect <mode> 
<mode> : = {on, off} 



The following selects Truce B (TB): 

CMD$="TB: SEL" ; CALL IBWRT ( SCOPE% , CMD$ ) 



RELATED COMMANDS TRACE 
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ACQUISITION 



SEQUENCE, SEQ 

Command/ Query 



DESCRIPTION 



COMMAND SYNTAX 



The SEQUENCE command sets the conditions for the sequence 
mode acquisition. The response to the sequence ? query gives the 
conditions for the sequence mode acquisition. The argument 
<max_size> can be expressed either as numeric fixed point, 
exponential or using standard suffixes. When the optional suffix num 
is used with the query, the response will be returned in standard 
numeric format. 

SEQuence <mode>[, <segments>[, <max_size>]] 

<mode> : = {off, qn} 

<segments> : = the right-hand column in the table below: 



Max. memory length 

PER CHANNEL 


Max. number oe 
SEGMENTS 


10 000 


50 


25 000 


50 


50 000 


200 


100 000 


500 


200 000 


500 


250 000 


500 


500 000 


2000 


1 000 000 


2000 


2 000 000 


2000 



<max_size> : = {... lOe+3, 10 . Oe+3,... lle+3,... }, for example, in 
standard numeric format. 
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QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 
RELATED COMMANDS 



Or, alternatively; 

= {50, 100, 250, 500, 1000, 2500, 5K, lOK, 25K, 50K, lOOK, 
2 5 OK, 50 OK, IM} 

However, values not absolutely identical to those listed immediately 
above will be recognized by the scope as numerical data (see the table 
under this heading in Chapter 1). For example, the scope will recognize 
1 . OM as 1 milhsample. But it will recognize l.OMA as 1 megasample. 



NOTE: The oscilloscc^ will adapt the requested <inax size> to 
the closest valid value , 



I F 

SEQuence? [NUM] 



SEQuence <mode>, <segments>, <max_size> 

<mode> : = {on, off} 

The following sets the segment count to 43, the maximum segment size 
to 250 samples, and turns the sequence mode 0 N : 

CMD$="SEQ ON, 43, 250": CALL IBWRT ( SCOPE% , CMD$ ) 



TRIG_MODE 
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RemotB Conbol Commands and Quaies 



MISCELLANEOUS 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 
RELATED COMMANDS 



SLEEP 

Command 



The SLEEP command makes the scope's remote command 
interpreter wait the time specified in the argument before interpreting 
any remote commands that follow. It is typically used to let an 
external signal settle before the scope performs new acquisitions and 
processing defined by the remote commands that follow. 



SLEEP <n> 

<n> : = time in seconds (0 to 1000.0) 

The following command causes the scope to sleep for 3.2 seconds. 

CMSD$="SLEEP 3.2";: CALL IBWRT (SCOPE%, CMD$ ) 



*TRG, WAIT 
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Part Two: COMMANDS 



STATUS 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 



*SRE 

Command/ Query 



The * SRE command sets the Service Request Enable register (SRE). 
This command allows you to specify which summary message bit or 
bits in the STB register will generate a service request. Refer to the 
table on page 210 for an overview of the available summary messages. 

A summary message bit is enabled by writing a 1' into the 
corresponding bit location. Conversely writing a '0' into a given bit 
location prevents the associated event from generating a service 
request (SRQ ). Clearing the SRE register disables SRQ interrupts 

The *SRE? query returns a value that, when converted to a binary 
number, represents the bit settings of the SRE register. Note that bit 6 
(MSS) cannot be set and its returned value is always zero. 



*SRE <value> 
<value> : = 0 to 255 



*SRE? 



*SRE <value> 



The following allows an SRQ to be generated as soon as the MAY 
summary bit (bit 4, i.e. decimal 16) or the INB summary bit (bit 0, i.e. 
decimal 1) in the STB register, or both, are set. Summing these two 
values yields the SRE mask 16+1 = 17. 

CMD$="*SRE 17"; CALL IBWRT ( SCOPE% , CMD$ ) 
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RemotB Conbol Commands and Quaies 



STATUS 

DESCRIPTION 

QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*STB? 

Query 



The * s TB ? query reads the contents of the 488.1 defined status 
register (STB), and the Master Summary Status (MSS). The 
response represents the values of bits 0 to 5 and 7 of the Status 
Byte register and the MSS summary message. 

The response to a * s tb ? query is identical to the response of a 
serial poll except that the MSS summary message appears in bit 6 
in place of the RQ S message. Refer to the table on page 210 for 
further details of the status register structure. 



*STB? 



*STB <value> 

<value> : = 0 to 255 

The following reads the status byte register: 

CMD$="*STB?" : CALL IBWRT ( SCOPE% , CMD$ ) : 
CALL IBRD (SCOPE%, RSP$) : PRINT RSP$ 

Response message: 

*STB 0 



ALL_STATUS, *CLS, *PRE, *SRE 
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ADDITIONAL INFORMATION 



Status Byte Register (STB) 


Bit 


Bit Value 


Bit Name 


Description 


Note 


7 


128 


DI07 


0 1 reserved for future use 




6 


64 


MSS/RQS 
MSS = 1 
RQS= 1 


at least 1 bit in STB masked by SRE is 1 
service is requested 


1. 

^ 1 


5 


32 


ESB 


1 1 an E SR enabled event has occurred 


3. ! 


4 


16 


MAV 


1 1 output queue is not empty 


4. 


3 


8 


DI03 


0 1 reserved 


5. 


2 


4 


VAB 


1 1 a command data value has been adapted 


1 


J 


DIOl 


0 1 reserved 




0 


1 


INB 


1 1 an enabled Internal state change has occurred 


6. 



NOTE: For the above table... 

1 The Master Sunmmy Status (MSS) indicates that the oscilloscope requests service, nhile the 
Service Request status— nhenset— spedffes that the oscilloscope issued a service request Bit 
position 6 depends on the poUinq method: 

Bit6=MSSif an *stb? query is received, 

= RQSif serial polling is conducted. 

2 Exarrqrle: If SRE = lOar^STB = 10thenMSS= 1 IfSRE = (Wand STB = mthmM^=a 

J The Event Status Bit (E SB) indicates whether ornot one orrrrore of the ettabled IEEE 48&2 
events have occurred since the last reading or clearing of the Standard Evmt Status Register 
(ESR). ESBis set if an errabled event becorrres true (1). 

4 The Message Available bit (MAV) indicates uhether ornot the Output queue is errrpty. TheMAV 
smrrmary bitis settrue (1) whmevera data byte resides in the Output queue. 

5. The Value Adapted Bit (VAB) is set true (1) whenever a data value in a corrrrrrand has been 
ad^ted to the nearest legal value. Forirrstance, the VAB bit would be set if the thr^rase is 
redeSned as 25ps/ divsince thead^tedvalueis2ps/div. 

& The INterrral state Bit (INB) is set true (h whertever certain errabled interrral states are entered. 
For further irrforrrration, refer to the inr query. 
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RemotB Conbol Commands and Quaies 



ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE 

RELATED COMMANDS 



STOP 

Command 



The STOP command immediately stops the acquisition of a signal. If 
the trigger mode is AUTO or NO RM, stop will place the 
oscilloscope in STOPPED trigger mode to prevent further 
acquisition. 



STOP 



The following stops the acquisition process: 

CMOS ="STOP": CALL IBWRT ( SCOPE% , CMD$ ) 



ARM_ACQUISITION, TRIG_MODE, WAIT 
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WAVEFORM TRANSFER STORE, STO 

Command 



DESCRIPTION The store command stores the contents of the specified trace 

into one of the internal memories Ml to M4 or to the current 
directory on mass storage. 



COMMAND SYNTAX 



AVAILABILITY 



STOre [<trace>,<dest>] 

<trace> : = {ta, tb, tc, td, ci, C2, C3, C4, all_displayed} 
<dest> : = {mi, M2, M3, M4, CARD, FLPY, HDD} 

TIP: If you send the store command without an argument 
all traces currently enabled in the Store Setup willbe stored. 
Modily this setup using store_setup. 



<trace> : = {C3, C4} only available on four-channel oscilloscopes. 

<dest> : CARD only available with Memory Card option installed. 

<dest> : HDD only available with removable Hard Disk option 
installed. 




EXAMPLE (GPIB) The following stores the contents of Trace A (TA) into Memory 1 

(Ml): 

CMD$="STO TA,M1": CALL IBWRT ( SCOPE% , CMD$ ) 

The following stores aU currently displayed waveforms onto the 
memory card: 

CMD$="STO ALL_D I SPLAYED, CARD": 

CALL IBWRT (SCOPE%, CMD$) 

The following executes the storage operation currently defined in 
the Storage Setup (see command STORE SETUP): 

CMD$="STO": CALL IBWRT (SCOPE%, CMD$ ) 



RELATED COMMANDS STORE_SETUP, RECALL 
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RemotB Conbol Commands and Quaies 

SAVE/ RECALL SETUP STORE_PANEL, STPN 

Command 



DESCRIPTION The store_panel command stores the complete front panel 

setup of your Waverunner oscilloscope, at the time the command is 
issued, into a file on the current directoiy on mass storage. 



NOTE; The communication parameters (the parameters moditied by conmiands comm_format, 
C0MM_HEADER, C0MM_HELP, C0MM_0RDER and WAVEFORM_SETUP) and the enable registers 
associated with the status reporting system (commands *SRE, *pre, *ese, ine) are not saved by 
this command. 

If no Slename (or an engjty string) is supplied the oxilloscope gmemtes a Slename according to its 
internal rules. \ — 



COMMAND SYNTAX 



STore_PaNei DISK, <device>, F I LE , '<filename>' 




<device> : = {card, flpy, hdd} 

<filename> : = A string of up to ei^t characters with the extension 

• PNL. 



AVAILABILITY <device> : card only available with Memory Card option installed. 

<device> : hdd only available with removable Hard Disk option 
installed. 



EXAMPLE (GPIB) The following saves the current Waverunner oscilloscope setup to 

the memory card in a file called "DIODE .PNL" : 

CMD$ = "STPN DISK, CARD, FILE, 'DIODE . PNL' " : 
CALL IBWRT (SCOPE%, CMD$) 

RELATED COMMANDS PNSU, *SAV, RECALL_PANEL, *RCL 
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Part Two: COMMANDS 



m VE FORM TRANSFER 
DESCRIPTION 



COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
AVAILABILITY 

EXAMPLE (GPIB) 
RELATED COMMANDS 



STORE_SETUP , STST 

Command/ Query 



The STORE_SETUP command controls the way in which traces will 
be stored. A single trace or all displayed traces can be enabled for 
storage. This applies to both auto-stoiing and to the store command. 
Traces can be auto-stored to mass storage after each acguisition until 
the mass storage device becomes full (FILL), or continuously (WRAP), 
replacing the oldest traces by new ones. 

The STORE_SETUP ? gueiy returns the current mode of operation of 
Autostore, the current trace selection, and the current destination. 



NOTE; You can recall into the oscilloscope only waveforms 
stored in BINARY forrrmt 






« 



STore_SeTup [<trace>, <dest>] [, auto, <mode>] [, format, <type>] 



<trace> : = {TA, TB, TC, TD, Cl, C2, C3, C4, ALL_D I splayed} 
<dest> : = {mi, M2, M3, M4, CARD, FLPY, HDD} 

<mode> : = {off, wrap, fill} 

<type> : {binary, spreadsheet, mathcad, matlab } 



STore_SeTup? 



STore_SeTup <trace>, <dest>, AUTO, <mode> 



<trace> : = {C3, C4} only available on four-channel oscilloscopes. 

<dest> : CARD only available with Memory Card option installed. 
<dest> : HDD only available with removable Hard Disk option installed. 



The following Channel 1 for storage. It enables an "autostore" to the 
card until no more space is left on the memory card (AUTO, FILL). 

CMD$="STST Cl, CARD, AUTO, FILL": 

CALL IBWRT (SCOPE%, CMD$) 

STORE, INR 
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RemotB Conbol Commands and Quaies 



WA VE FORM TRANSFER 

DESCRIPTION 

COMMAND SYNTAX 
AVAILABILITY 

EXAMPLE (GPIB) 

RELATED COMMANDS 



STORE_TEMPLATE, STTM 

Command 



The STORE_TEMPLATE command stores your Waverunner 
oscilloscope's waveform template on a mass-storage device. A 
filename is automatically generated in the form of lecroyw . tpl 
where vv is the two-digit revision number. 

For example, for revision 2.1, the file name generated will be 

LECROY21 .TPL. 

See Chapter 4 for more on the waveform template, and Appendix II 
for a copy of the template itself. 



STore_TeMplate DISK, <device> 
<device> : = {card, flpy, hdd} 



<device> : card only available with the Memory Card option installed. 
<device> : hdd only available with removable Hard Disk option 
installed. 



The following stores the current waveform template on the memory 
card for future reference: 

CMD$="STTM DISK, CARD"; CALL IBWRT 
(SCOPE%, CMD$) 



TEMPLATE 
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Part Two: COMMANDS 



MISCELLANEOUS 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 



TDISP 

Command/ Query 



The TDISP command controls the presence and format of the time 
and date display on the oscilloscope screen. The keyword 
CURRENT selects the current time and date for d%)lay. The 
keyword NONE removes both time and date. The keyword 
TWG G ER selects the trigger time of the uppermost waveform 
currently displayed. 



TDISP <state> 

<State> : = {current, NONE, trigger} 

TDISP? 

TDISP <state> 

The following turns off the time and date di^lay on the oscilloscope 
screen: 

CMD$="TDISP NONE": CALL IBWRT ( SCOPE% , CMD$ ) 
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WA VE FORM TRANSFER 
DESCRIPTION 

QUERY SYNTAX 
RESPONSE EORMAT 

RELATED COMMANDS 



TEMPLATE?, TMPL? 

Query 



The TEMP LATE ? queiy produces a copy of the template which 
formally describes the various logical entities making up a complete 
waveform. In particular, the template describes in full detail the 
variables contained in the descriptor part of a waveform. 

See Chapter 4 for more on the waveform template, and Appendix II 
for a copy of the template itself. 



TeMPLate? 



TeMPLate "<template>" 

<template> : = A variable length string detailing the structure of a 
waveform. 



INSPECT 
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Part Two: COMMANDS 



ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



TIME_DIV, TDIV 

Command/ Query 

The T IME_D IV command modifies the timebase setting. The new 
timebase setting can be specified with suffixes: NS for nanoseconds, 
US for microseconds, MS for milliseconds, S for seconds, or KS for 
Moseconds. An out-of-range value causes the VAB bit (bit 2) in the 
STB register (see table on page 210) to be set. 

The T IME_D IV? gueiy returns the current timebase setting 
Time_Div <value> 

<value> : = See the Operator's Manual for specifications. 

The suffix S (seconds) is optional. 

Time_DIV? 

Time_Div <value> 

The following sets the time base to 500 psec/ div: 

CMD$="TDIV 500US": CALL IBWRT ( SCOPE% , CMD$ ) 

The following sets the time base to 2 msec/ div: 

CMDS="TDIV 0.002": CALL IBWRT ( SCOPE% , CMD$ ) 

TRIG_DELAY, TRIG_MODE 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 

RESPONSE EORMAT 
AVAILABILITY 

EXAMPLE (GPIB) 



TRACE, TRA 

Command/ Query 



The TRACE command enables or disables the display of a trace. An 
environment error (see table on page 124) is set if an attempt is made 
to display more than four waveforms. 

The TRACE ? query indicates whether the specified trace is displ^ed 
or not. 



<trace> : tracg <mode> 

<trace> : = {ci, C2, C3, C4, ta, tb, tc, td} 
<mode> : = {on, off} 



<trace> : tracg? 



<trace> : TRAce <mode> 

<trace> : = {C3, C4} only on four-channel Waverunner oscilloscopes. 
The following di^lays Trace A (TA): 

CMD$="TA:TRA ON"; CALL IBWRT ( SCOPE% , CMD$ ) 
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Part Two: COMMANDS 



DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 

RESPONSE EORMAT 
EXAMPLE (GPIB) 



TRACE_OP AC I T Y , TOP A 

Command/ Query 



The TRACE_OPACiTY command controls the opacity and the 
transparency of the trace color. The trace can be made either opaque 
(traces will overwrite and obscure each other) or tran^arent 
(overlapping traces can be distinguished from one another). 

The response to the trace_opac i t y ? query indicates whether 
the traces are opaque or transparent. 



Trace_OPAcity <type> 

<type> : = {opaque, transparent} 



Trace_OPAcity? 



Trace_OPAcity <type> 



The following allows traces to be distinguished even when they overlap: 

CMD$="TOPA TRANSPARENT"; CALL 
BWRT (SCOPE%, CMD$) 
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ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



*TRG 

Command 



The * TRG command executes an ARM command. * trg is the 
equivalent of the 488.1 G ET (Group Execute Trigger) message. 



*TRG 

The following enables signal acquisition: 

CMD$="*TRG": CALL IBWRT ( SCOPE% , CMD$ ) 

ARM_ACQUISITION, STOP, WAIT 
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Part Two: COMMANDS 



ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
AVAILABILITY 

EXAMPLE (GPIB) 
RELATED COMMANDS 



TRIG_COUPLING, TRCP 

Command/ Query 



The TRiG_couPLiNG command sets the coupling mode of the 
specified trigger source. 

The TRi G_coup LING? gueiy returns the trigger coupling of the 
selected source. 



NOTE; The oscilloscope automatically detenaines trigger 
slope when in HFDIV cmqjling The trig_SLOPE command 
is not used in HFDIV coupling imde. 

HFDIV is indicated as HFin the bigger sHup menus. 



<ttig_source> : XRig_CouPling <ttig_couplmg> 
<trig_source> : = {ci, C2, c3,C4,ex, exio} 
<trig_coupling> : = {ac, dc, hfrej, lfrej} 



<ttig_SOUrce> : XRig_CouPling? 

<ttig_source> : XRig_CouPling <ttig_coupling> 

<ttig_source> : = {C3, C4} only on four-channel Waverunner 
oscilloscopes. 



The following sets the coupling mode of the trigger source Channel 
2 to AC: 

CMD$="C2 :XRCP AC": CALL IBWRX ( SCOPE% , CMD$ ) 



XRIG_COUPLING, XRIG_DELAY, XRIG_LEVEL, 
XRIG_MODE, XRIG_SELECX, XRIG_SLOPE, 
XRIG_WINDOW 
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ACQUISITION TRIG_DELAY, TRDL 

Command/ Query 

DESCRIPTION The TRIG_DELAY conmiand sets the time at which the trigger is to 

occur in respect of the first acquired data point (di^layed at the left- 
hand edge of the screen). 

Positive trigger del^s are to be expressed as a percentage of the full 
horizontal screen. This mode is ciled pre- trigger acquisition, as data 
are acquired before the trigger occurs. Negative trigger delays must 
be given in seconds. This mode is called post-trigger acquisition, as 
the data are acquired after the trigger has occurred. 

If a value outside the range -10 000 div x time/ div and 100 % is 
specified, the trigger time will be set to the nearest limit and the VAB 
bit (bit 2) will be set in the STB register. 

The response to the T R i g_d e la y ? query indicates the trigger time 
with respect to the first acquired data point. Positive times are 
express^ as a percentage of the full horizontal screen and negative 
times in seconds. 

COMMAND SYNTAX TRig_DeLay <value> 

<value> : = 0.00 PCT to 100.00 PCT (pretrigger) 

-20 PS to -10 MAS (post-trigger) 



NOTE: The sufBx is optional For positive manbeis the sufBx PCT is assumed. For negative numheis 
the sufSx S is assumed. MASisthesu£BxforMs(megaseconds), usefuioniyforexbemeiyiaigedeiays 
atveiysiowtimebases. . — 
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Part Two: COMMANDS 



QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



TRig_DeLay? 



TRig_DeLay <value> 

The following sets the trigger delay to -20 s (post- trigger): 

CMD$="TRDL -20S": CALL IBWRT ( SCOPE% , CMD$ ) 



TIME_DIV, TRIG_COUPLING, TRIG_LEVEL, 
TRIG_MODE, TRIG_SELECT, TRIG_SLOPE, 
TRIG_WINDOW 
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ACQUISITION TRIG_LEVEL, TRLV 

Command/ Query 

DESCRIPTION The trig_level command adjusts the trigger level of the 

specified trigger source. An out-of-range value will be adjusted to the 
closest legal value and will cause the VAB bit (bit 2) in the STB 
register to beset. 

The TRIG_LEVEL? gueiy returns the current trigger level. 

<ttig_source> : TRig_LeVei <ttig_level> 

<trig_source> : = {ci, C2, c3,C4,ex, exio} 

<trig_level> : = 



QUERY SYNTAX <trig_source> : TRig_LeVel? 



RESPONSE EORMAT <ttig_source> : TRig_LeVel <ttig_level> 



AVAILABILITY <ttig_source> : = {C3, C4} only on four-channel Waverunner 

oscilloscopes. 



EXAMPLE (GPIB) The following adjusts the trigger level of Channel 2 to -3.4 V : 

CMD$="C2: TRLV -3.4V": CALL IBWRT (SCOPE%, CMD$ ) 



RELATED COMMANDS TRIG_COUPLING, TRIG_DELAY, TRIG_M0DE, 

TRIG_SELECT, TRIG_SLOPE, TRIG_WINDOW 



COMMAND SYNTAX 



NOTE: The sufBx v is optional. 
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Part Two: COMMANDS 



ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



TRIG_MODE, TRMD 

Command/ Query 

The TRiG_MODE command specifies the trigger mode. 

The TRiG_MODE? guery returns the current trigger mode. 

TRig_MoDe <mode> 

<mode> : = {auto, norm, single, stop} 



TRig_MoDe? 

TRig_MoDe <mode> 

The following selects the normal mode: 

CMD$="TRMD NORM"; CALL IBWRT ( SCOPE% , CMD$ ) 



ARM_ACQUISITION, STOP, TRIG_SELECT, SEQUENCE, 
TRIG_COUPLING, TRIG_LEVEL, TRIG_SLOPE, 
TRIG_WINDOW 
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RemotB Conbol Commands and Quaies 



ACQUISITION 



TRIG_SELECT, TRSE 

Command/ Query 



DESCRIPTION The trig_select command selects the condition that will trigger 

the acguisition of waveforms. Depending on the trigger type, 
additional parameters must be specified. These additional parameters 
are grouped in pairs. The first in the pair names the variable to be 
modified, while the second gives the new value to be assigned. Pairs 
can be given in any order and restricted to those variables to be 
changed. 

TheTRiG_SELECT? guery returns the current trigger condition. 



r Trigger Notation 


DROP 


Dropout 


QL 


Qualifier 


EDGE 


Edge 


SNG 


1 Sin^e source 


EV 


Event 


SQ 


1 State-Qualified 


GLIT 


Glitch 


SR 


1 Source 


HT 


Hold type 


STD 


1 *Standard (Edge Trigger) 


HV 


Hold value 


TEQ 


1 Edge-Qualified 


HV2 


Second hold value 


TI 


Time 


IL 


Interval larger 


TL 


Time within 


INTV 


Interval 


TV 


TV 


IS 


Interval smaller 


CHAR 


1 Characteristics 


12 


Interval-width window 


FLD 


1 Eield 




No hold-off on wait 


FLDC 


1 Eield coimt 


PL 


Pulse larger 


I LAC 


1 Interlace 


PS 


Pulse smaller 


LINE 


1 Line 


P2 


Pulse- width window 


LPIC 


1 Lines per picture 



COMMAND SYNTAX 



For aU but TV Trigger TRig_SElect 
<trig_type>, SR, <source>, ql, <source>, 

HT, <hold_type>, hv, <hold_value>, hv 2 , <hold value> 



* HT and HV do not ^ply to the Standard Trigger. 
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Part Two: COMMANDS 



QUERY SYNTAX 
RESPONSE EORMAT 

AVAILABILITY 
EXAMPLE (GPIB) 



<trig_type> : = {drop, edge, glit, intv, std, sng, sq, 
teq} 

<SOUrce> : = {ci, C2, C3,C4,LINE, ex, exio,pa} 
<hold_type> : = {ti, tl, ev, ps, pl, is, il, p2, i2, off} 



<hold value> : = See Operator's Manual for valid values 




NOTE: The sufBx S (seconds) is optional 


i 




7 



TRig_SElect? 



TRig_SElect 

<trig_type>, SR, <source>, ht, <hold type>, hv, 
<hold_value> , <hold_value> 

HV2 only returned if <hold_type> is P2 or 12 



<source> : {C3, C4} only available on four-channel Waverunner 
oscilloscopes. 



The following selects the sin^e-source trigger with Channel 1 as trigger 
source. Hold type and hold value are chosen as "pulse smaller" than 
20 ns: 

CMD$="TRSE SNG, SR, Cl, HT, PS, HV, 20 NS": 

CALL IBWRT (SCOPE%, CMD$) 



228 



I SSUE D : January 2002 



LTXXX-RCM-E Rev B 
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TV COMMAND SYNTAX 



QUERY SYNTAX 
RESPONSE EORMAT 

AVAILABILITY 
EXAMPLE (GPIB) 

RELATED COMMANDS 

LTXXX-RCM-E Rev B 



TRig_SElect 

<trig_type>, sr, <source>, fldc, <field_count>, fld, <field>, 

CHAR, <characteristics>, lpic, <lpic>, ilac, <ilace>, line, <line> 

<trig_type> : = {tvp , tvn} TVP=TV Pos, TVN=TV Neg 

<SOUrce> : = {ci, C2, C3, C4, NE, EX, EXIO} 

<field_coimt> : = {i, 2 } 

<field> : = 1 to field_ count 

<characteristics> : = {NTSC, palsec, custso, cust60} 

<lpic> : = 1 to 1500 
<ilace> : = {i, 2} 

<line> : = 1 to 1500 or 0 for any line 

The FLD value is interpreted with the current fldc value. The line 
value is interpreted with the current fld and char values. 

TRig_SElect? 



TRig_SElect 

TVP, SR, <souTce>, FLDC, <fleld_count>, fld, <field>. 



CHAR, <characteristic>, line, <lme> 



<source> : = {C3, C4} only on four-channel Waverunner 
oscilloscopes. 



The following sets up the trigger system to trigger on the 3rd field, line 
17, of the eight-field PAL/ SECAM TV signal applied to the external 
input. 

CMD$="TRSE TVN, SR, EX, FLDC, 8, FLD, 3, CHAR, PALSEC, 
LINE, 17"; CALL IBWRT ( SCOPE% , CMD$ ) 



TRIG_COUPLING, TRIG_DELAY, TRIG_LEVEL, 
TRIG_MODE, TRIG_SLOPE, TRIG_WINDOW 
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Part Two: COMMANDS 



ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
AVAILABILITY 

EXAMPLE (GPIB) 
RELATED COMMANDS 



TRIG_SLOPE, TRSL 

Command/ Query 



The TRiG_SLOPE command sets the trigger slope of the specified 
trigger source. An environment error (see table on page 124) will be 
generated when an incompatible TRSL order is received while the 
trigger coupling is set to HFDIV (see trig_coupling). 

The TRiG_SLOPE? guery returns the trigger slope of the selected 
source. 



<trig_source> : TRig_SLope <trig_slope> 
<trig_source> := {ci, C2, C3, C4, line, ex, EXio} 
<trig_slope> : = {neg, pos, window} 



<trig_SOUrce> : TRig_SLope? 

<trig_source> : TRig_SLope <trig_slope> 

<trig_source> : = {C3, C4} only available on four-channel 
oscilloscopes. 

The following sets the trigger slope of Channel 2 to negative: 

CMD$="C2 :TRSL NEG": CALL IBWRT ( SCOPE% , CMD$ ) 



TRIG_COUPLING, TRIG_DELAY, TRIG_LEVEL, 
TRIG_MODE, TRIG_SELECT, TRIG_SLOPE, 
TRIG_WINDOW 
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ACQUISITION TRIG_WINDOW, TRWI 

Command/ Query 

DESCRIPTION The TRIG WINDO W command sets the window amplitude in volts 

on the current Edge trigger source. The window is centered around 
the Edge trigger level 

The TRIG WINDOW? query returns the current window amplitude. 

COMMAND SYNTAX TRig_ _window <value> 

<value> : = 0 to 25 V (maximum range) 




QUERY SYNTAX TRig_WIndow? 

RESPONSE EORMAT TRig_ _window <trig_level> 

EXAMPLE The following adjusts the window size to +0.5 V : 

CMD$="TRWI 0.5V": CALL IBWRT ( SCOPE% , CMD$ ) 

RELATED COMMANDS TRIG_COUPLING, TRIG_DELAY, TRIG_LEVEL, 

TRIG_MODE, TRIG_SELECT, TRIG_SLOPE 
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Part Two: COMMANDS 



MISCELLANEOUS 

DESCRIPTION 

QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 
RELATED COMMANDS 



*TST? 

Query 



The * T s T ? query performs an internal self- test, the response 
indicating whether the self- test has detected any errors. The self- test 
includes testing the hardware of all channels, the timebase and the 
trigger circuits. 

Hardware failures are identified by a unique binary code in the 
returned <status> number. A "0" response indicates that no fahirres 
occurred. 



*TST? 

*TST <status> 

<status> : = 0 self-test successful 

The following causes a self-test to be performed: 

CMDS="*TST?" ; CALL IBWRT ( SCOPE% , CMD$ ) : 
CALL IBRD (SCOPE%, RD$) ; PRINT RD$ 

Response message (if no failure): 

*TST 0 



*CAL 
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STATUS 

DESCRIPTION 



QUERY SYNTAX 
RESPONSE EORMAT 

EXAMPLE (GPIB) 



URR? 

Query 



The URR? query reads and clears the contents of the User Request 
status Register (URR). The URR register ^ecifies which button in 
the menu field was pressed. 

In remote mode, the URR register indicates the last button was 
pressed, provided it was activated with a KEY command (see page 
154). In local mode, the URR register indicates whether the CALL 
HO ST button has been pressed. If no menu button has been pressed 
since the last URR? query, the value 0 is returned. 



User Request Status Register Structure (URR) 


Value 


Description 


0 


No button has been pressed 


1 


The top menu button has been pressed 


2 


The second-from-top menu button has been pressed 


3 


The third-from-top menu button has been pressed 


4 


The fourth-from-top menu button has been pressed 


5 


The fifth-from-top menu button has been pressed 


100 


When the "Call Host" command is "On" (the bottom button 
for the root, or primary, menu has been pressed) 



URR? 

URR <value> 

<value> : = 0 to 5, 100 

The following reads the contents of the URR register: 

CMD$="URR?": CALL IBWRT ( SCOPE% , CMD$ ) : 
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RELATED COMMANDS 



CALL IBRD (SCOPE%, RSP$) : PRINT RSP$ 

Response message: 

URR 0 



CALL_HOST, KEY, ALL_STATUS, *CLS 



234 



I SSUE D : January 2002 



LTXXX-RCM-E Rev B 




RemotB Conbol Commands and Quaies 



DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE 

RELATED COMMANDS 



VERT_MAGNIFY, VMAG 

Command/ Query 

The VERT_MAGNiF Y command vertically expands the ^ecified trace. 
The command is executed even if the trace is not displayed. 

The maximum magnification allowed depends on the number of 
significant bits associated with the data of the trace. 

The VERT_MAGN I F Y ? query returns the magnification factor of the 
specified trace. 

<trace> : Vert_MAGnify <factor> 

<trace> : = {ta, tb, tc, td} 

<factor> : = 4.0E-3 to 50 (maximum) 

<trace> : Vert_MAGnify? 

<trace> : Vert_MAGnify <factor> 

The following enlarges the vertical amplitude of Trace A by a factor of 
3.45 with respect to its original amplitude: 

CMD$="TA:VMAG 3.45": CALL IBWRT (SCOPE%, CMD$ ) 
VERT_POSITION 
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Part Two: COMMANDS 



DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE 

RELATED COMMANDS 



VERT_POSITION, VPOS 

Command/ Query 



The VE RT_p 0 s I T I ON command adjusts the vertical position of 
the specified trace on the screen. It does not affect the original offset 
value obtained at acquisition time. 

The VERT_POSiTiON? query retums the current vertical position 
of the specified trace. 



<trace> : Vert_POSiTiON <di^lay_offset> 
<trace> : = {ta, tb, tc, td} 

<display_offset> : = -5900 to +5900 DIV 



NOTE; The suffix DIV is optional. The limits depend on the 
ament magnihcation factor, the number of grids on the display, 
and the initial position of the time. 






<trace> : Vert_POSition? 



<tiace> : Vert_POSiTiON <di^lay_offset> 

The following shifts Trace A (TA) upwards by +3 divisions relative to 
the position at the time of acquisition: 

CMD$="TA:VPOS 3DIV": CALL IBWRT ( SCOPE% , CMD$ ) 



VERT_MAGNIFY 
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ACQUISITION V0LT_DIV, VDiv 

Command/ Query 



DESCRIPTION The volt_d iv command sets the vertical sensitivity in Volts/ div. 

The VAB bit (bit 2) in the STB register (see table on page 210) is set 
if an out-of-range value is entered. 

The probe attenuation factor is not taken into account for adjusting 
vertical sensitivity. 

The V0LT_D IV? query returns the vertical sensitivity of the 
specified channel. 



COMMAND SYNTAX 



<channel> : Volt_Div <v_gain> 



<channel> : = {ci, C2, C3, C4} 

<v gain> : = See Operator's Manual for specifications. 



NOTE: ThesufSx Vis optional 


— 




r 



QUERY SYNTAX 



<channel> : Voit_Div? 



RESPONSE EORMAT <channel> : Volt_Div <v_gain> 

AVAILABILITY 

<channel> : = {C3, C4} only available on four-channel oscilloscopes. 



EXAMPLE 



The following sets the vertical sensitivity of channel 1 to 50 mV/ div: 

CMD$="C1 :VDIV 50MV": CALL IBWRT ( SCOPE% , CMD$ ) 
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Part Two: COMMANDS 



STATUS 

DESCRIPTION 

COMMAND SYNTAX 
RELATED COMMANDS 



*WAI 

Command 



The *WAi (WAIt to continue) command, required by the IEEE 
488.2 standard, has no effect on the oscilloscope, as Waverunner 
only starts processing a command when the previous command has 
been entirely executed. 



*WAI 



*OPC 
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ACQUISITION 

DESCRIPTION 

COMMAND SYNTAX 
EXAMPLE (GPIB) 

RELATED COMMANDS 



WAIT 

Command 



The WAIT command prevents your Waverunner oscilloscope from 
analyzing new commands until the oscilloscope has completed the 
current acquisition. The optional argument specifies the timeout (in 
seconds) after which the scope will stop waiting for new acquisitions. If 
<t> is not given, or if <t> = 0.0, the scope will wait indefinitely. 



WAIT [<t>] 

<t>:=timeout in seconds (0.0 to 1000.0, default is indefinite) 



send: "trmd single" 

loop {send:"ARM; WAIT; CI : PAVA?MAX" 
read response 
process response 
} 

This example finds the maximum amplitudes of several signals 
acquired one after another. ARM starts a new data acquisition. The 
WAIT command ensures that the maximum is evaluated for the 
newly acquired waveform. 

c I : PAVA7MAX instructs the oscilloscope to evaluate the maximum 
data value in the Channel 1 waveform. 



*TRG SLEEP 
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Part Two: COMMANDS 



m VE FORM TRANSFER 
DESCRIPTION 



COMMAND SYNTAX 



WAVEFORM, WF 

Command/ Query 



A WAVEFORM command transfens a waveform from the controller to 
the oscilloscope, whereas a waveform? query transfers a waveform 
from the oscilloscope to the controller. 

WAVEFORM stores an external waveform back into the oscilloscope's 
internal memory A waveform consists of several distinct entities: 

the descriptor (desc) 

the user text (text) 

the time (time) descriptor 

the data (dati) block, and, optionally 

a second block of data (d at 2). 

See Chapter 4 for further information on waveform structure. 



NOTE; You can restore to the oscilloscope only mrrrplete 
waveforms queried with waveform? all. 



The WAVEFORM? query instructs the oscilloscope to transmit a 
waveform to the controller. The entities can be queried independently. 
If the "ALL" parameter is specified, all four or five entities are 
transmitted in one block in the order enumerated above. 




NOTE: The format of the waveform data depends on the current 
settings speciBed by the last WAVEFORM_SETUP, comm_ord er 
and COMM_FORMAT commands. I — 






<memory> : WaveForm all <waveform_data_block> 
<memory> : = {mi, m2, m3, M4} 

<waveform_data_block> : = Arbitrary data block (see Chapter 5). 
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QUERY SYNTAX 



RESPONSE EORMAT 



AVAILABILITY 



EXAMPLES (GPIB) 



<trace> : WaveForm? <block> 

<trace> : = {TA, TB, TC,TD, M1,M2,M3,M4,C1,C2,C3,C4} 

<block> : = {DESC, text, time, DATl, DAT2, ALL} 

If you do not give a parameter, ALL will be assumed. 



<trace> : WaveForm <block>, <waveform_data_block> 



TIP: It may be convenient to disable the response header If the 
waveform Is to be restored. See the comm_header command for 
firrlher details. 



<trace> : = {C3, C4} only available on four-channel oscilloscopes. 




The following reads the block DATl from Memory 1 and saves it in 
the file "MEM1.DAT". The path header "ML" is saved together with 
the data 

FILES = "MEM1.DAT" 

CMOS = "M1:WF? DATl" 

CALL IBWRT (SCOPE%, CMOS) 

CALL IBRDF (SCOPE%, FILES) 

In the following example, the entire contents of Channel 1 are saved in 
the file "CHAN1.DAT". The path header "CL" is skipped to ensure 
that the data can later be recalled into the oscilloscope. 

FILES="CHAN1 .DAT" ;RDS=SPACES (3) 

CMDS="CHDR SHORT; CI:WF?" 

CALL IBWRT (SCOPE%, CMDS) 

CALL IBRD (SC0PE%, RDS) Skip first 3 characters "CL" 

CALL IBRDF (SC0PE%, FILES) Save detain file "CHAN1.DAT" 

The following illustrates how the waveform data saved in the preceding 
example can be recalled into Memory L 

FILES = "CHAN1.DAT" 

CMDS ="M1:" 

CALL IBEOT (SC0PE%, 0) disable EOI 
CALL IBWRT (SCOPE%, CMDS) 

CALL IBEOT (SC0PE%, 1) re-enable EOI 
CALL IBWRTF (SCOPE%, FILES) 
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RELATED COMMANDS 



The "Ml:" command ensures that the active waveform is "Ml". 
When the data file is sent to the oscilloscope, it first sees the header 
"WF" (the characters "Cl:" having been skipped when reading the 
file) and assumes the default destination "Ml". 



INSPECT, COMM_FORMAT, COMM_ORDER, 
FUNCTION_STATE, TEMPLATE, WAVEFORM_SETUP , 
WAVEFORM_TEXT 
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Remote Conbol Commands and Quaies 

WAVEFORM TRANSFER WAVEFORM_SETUP , WFSU 

Command/ Query 

DESCRIPTION The WAVEFO RM SETUP command specifies the amount of data in 

a waveform to be transmitted to the controller. The command controls 
the settings of the parameters listed below. 



j Notation 


FP 


[ first point 




NP 


1 number of points 


SN 


segment number 




SP 


sparsing 



praising (SP): The parsing parameter defines the interval between data points. For 

example: 

SP = 0 sends all data points 

SP = 1 sends all data points 

SP = 4 sends every 4th data point 

Numberof points (NP): Thenumberof points parameter indicates how many points should be 

transmitted. For example: 

NP = 0 sends all data points 

NP = 1 sends 1 data point 

NP = 5 0 sends a maximum of 50 data points 

NP = 10 01 sends a maximum of 1001 data points 

First point (FP): The first point parameter ^ecifies the address of the first data point to 

be sent. For waveforms acquired in sequence mode, this refers to the 
relative address in the given segment. For example: 

FP = 0 corresponds to the first data point 

FP = 1 corresponds to the second data point 

FP = 50 0 0 corresponds to data point 5001 
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QUERY SYNTAX WaveForm_SetUp? 



RESPONSE EORMAT WaveForm_SetUp 

SP, <sparsmg>,NP,<number>,FP,<pomt>,SN, <segment> 



EXAMPLE (GPIB) The following instructs every 3rd data point (SP=3) starting at address 

200 to be transferred: 

CMD$="WFSU SP, 3, FP, 200" : CALL 
IBWRT (SCOPE%, CMD$) 



RELATED COMMANDS INSPECT, WAVEFORM, template 
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WA VE FORM TRANSFER 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 

RESPONSE EORMAT 
AVAILABILITY 

EXAMPLE (GPIB) 

RELATED COMMAND 



WAVEFORM_TEXT, WFTX 

Command/ Query 



The WAVEFORM_TEXT command is used to document the 
conditions under which a waveform has been acquired. The text 
buffer is limited to 160 characters. 

The WAVEFORM_TEXT ? query returns the text section of the 
specified trace. 



<trace> : WaveForm_TeXt '<text>' 

<trace> : = {ta, tb, tc, td, mi, m2, m 3, M4, Cl, C2, C3, 
C4} 

<text> : = An ASCII message (max. 160 characters long) 



<trace> : WaveForm_TeXt? 



<trace> : WaveForm_TeXt "<text>" 



<trace> : = {C3, C4} only on four-channel Waverunner oscilloscopes. 



The following documents Trace A (TA): 

MSG$= "'Averaged pressure signal. Experiment 
carried out Jan. 15, 98'" 

CMD$= "TA:WFTX"+ MSG$ : CALL IBWRT (SCOPE%, CMD$ ) 



INSPECT, WAVEFORM, TEMPLATE 
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Part Two: COMMANDS 



DISPLAY 

DESCRIPTION 

QUERY SYNTAX 
RESPONSE EORMAT 

AVAILABILITY 
EXAMPLE (GPIB) 

RELATED COMMANDS 



XY_ASSIGN?, XYAS? 

Query 



The X Y_AS SIGN? query retxuns the truces currently assigned to the 
X Y display. If there is no truce assigned to the X or Y axis the value 
UNDEF will be returned instead of the truce name. 



XY_ASsign? 

XY_ASsign <X_source>, <Y_source> 

<X_SOUrce> : = {UNDEF, TA, TB, TC, TD, Cl, C2, C3,C4} 
<Y_source> : = {undef, TA, TB, TC, TD, Cl, C2, C3, C4} 

<X_source> : = {C3, C4} only available on four-channel oscilloscopes. 
<Y_source> : = {C3, C4} only available on four-channel oscilloscopes. 

The following query finds the truces assigned to the X axis and the 
Y axis respectively: 

CMDS$="XYAS?" : CALL IBWRT ( SCOPE% , CMDS$ ) 

Example of response message: 

XYAS C1,C2 



TRACE 
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CURSOR 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



XY_CURSOR_ORIGIN, XYCO 

Command/ Query 



The XY_cuRSOR_ORiGiN command sets the position of the 
origin for absolute cursor measurements on the XY display. 

Absolute cursor values can be measured either with respect to the 
point (0,0) volts (off) or with respect to the center of the XY grid 

(ON). 

The XY_CURS0R_0RIGIN? query returns the current assignment 
of the origin for absolute cursor measurements. 



XY_Cursor_Origin <mode> 

<mode> : = {on, off} 



XY_Cursor_Origin? 



XY_Cursor_Origin <mode> 

The following sets the origin for absolute cursor measurements to 
the center of the XY grid. 

CMDS$="XYCO ON": CALL IBWRT ( SCOPE% , CMDS$ ) 
XY_CURSOR_VALUE 
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Part Two: COMMANDS 



CURSOR 

DESCRIPTION 



COMMAND SYNTAX 



XY_CURSOR_SET, XYCS 

Command/ Query 



The XY_cuRSOR_SET command allows you to position any one of 
the six independent XY voltage cursors at a given screen location. 
The positions of the cursors can be modified or queried even if the 
required cursor is not currently di^layed or if the XY display mode 
is OFF. 

The XY_CURS0R_SET ? query indicates the current position of the 
cirrsor or cursors. 

The cuRSOR_SET command is used to position the time cursors. 



■ 


Notation 


XABS 


vertical absolute on X axis 


XREF 


vertical reference on X axis 


XDIF 


vertical difference on X axis 


YABS 


vertical absolute on Y axis 


YREF 


vertical reference on Y axis 


YDIF 


vertical difference on Y axis 



XY_Cursor_Set 

<cursor>, <position>[, <cirrsor>, <position>, ...<cursor>, 
<position>] 

<CUrsor> : = {XABS, xref, xdif, yabs, yref, ydif} 



<position> : = -4 to 4 D IV 
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RemotB Conbol Commands and Quaies 



QUERY SYNTAX 



RESPONSE EORMAT 



EXAMPLE (GPIB) 



RELATED COMMANDS 



XY_Cursor_Set? [<cursor, ...<cursor>] 

<CUrsor> : = {XABS, XREF, XDIF, YABS, YREF, YDIF, all} 

If <cursor> is not specified, ALL will be assumed. 



XY_Cursor_Set 

<cuTsor>, <position>[, <cursor>, <position>..., <cursor>, 
<position>] 



The following positions the XREF and YDIF at +3 DIV and -2 DIV 
respectively. 

CMDS$="XYCS XREF, 3DIV, YDIF, -2DIV" : CALL 
IBWRT (SCOPE%, CMDS$) 



XY_CURSOR_VALUE, CURSOR_MEASURE , CURSOR_SET 
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Part Two: COMMANDS 



CURSOR 

DESCRIPTION 



QUERY SYNTAX 



XY_CURSOR_VALUE?, XYCV? 

Query 



The XY_cuRSOR_VALUE ? queiy returns the current values of the X 
versus Y cursors. The X versus Y trace does not need to be displayed to 
obtain these parameters, but valid sources must be assigned to the X 
andY axes. 



1 Notation 


<cursortype> : = [habs, hrel, vabs, vrel] , 


1 <cursor type>_x 


X 


<cursor type>_Y 


Y 


<cursor type>_RAT i o 


AY/ AX 


<cursor type>_PROD 


AY*AX 


<cursor type>_ANGLE 


arctan(AY/AX) 


<cursor type>_RAD i u s 


sqrt(AX*AX + AY*AY) 



XY_Cur s o r_va lue ? [<parameter>,...<parameter>] 

<parameter> : = {habs_x, habs_y, habs_ratio, habs_prod, 

HABS_ANGLE, HABS_RADIUS, HREL_X, HREL_Y, HREL_RATIO, 
HREL_PR0D, HREL_ANGLE, HREL_RADIUS, VABS_X, VABS_Y, 
VABS_RATIO, VABS_PROD, VABS_ANGLE, VABS_RADIUS, 
VREL_X, VREL_Y, VREL_RATI0, VREL_PR0D, VREL_ANGLE, 



VREL_RADIUS, ALL} 


NOTE; If <paiameter> is not spedffed or equals ALL, all the 
nKasmed cmsorvalues aw letumed. If the value of a cursor 
could not be determined in the curwntenviwnment, the valut 
UNDEF will be wtumed. If no trace has been assigned to eib 
theX axis or the Y axis, an enviwnment erwrwill be 
generated. 


2 

her 




/ 
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RESPONSE EORMAT 



EXAMPLE (GPIB) 



RELATED COMMANDS 



XY_Cursor_vaiue <parameter>, <value>[, ...<parametei>, <value>] 
<value> : = A decimal value or UNDEF 



The following query reads the ratio of the absolute horizontal cursor, 
the an^e of the relative horizontal cursor, and the product of the 
absolute vertical cursors: 

CMDS$="XYCV? HABS_RATIO, HREL_ANGLE, VABS_PROD : 
CALL IBWRT (SCOPE%, CMDS$) 

CURSOR_MEASURE, CURSOR_VALUE , XY_CURSOR_ORIGIN 
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Part Two: COMMANDS 



DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



XY_DISPLAY, XYDS 

Command/ Query 

The XY_D I SPLAY command turns the X Y di^lay mode on or off. 
(When off, the scope will be in standard display mode.) 

The X Y_D ISP LAY ? query returns the current mode of the X Y 
display. 

xY_DiSpiay <mode> 

<mode> : = {on, off} 

XY_DiSplay? 

XY_DiSpiay <mode> 

The following turns on the XY display: 

CMDS$="XYDS ON": CALL IBWRT ( SCOPE% , CMDS$ ) 

GRID 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 



XY_RENDER, XYRD 

Command/ Query 



The XY RENDER command controls the rendering of the XY plot on 
screen. In Smooth mode, the dots representing XY pairs are connected. 
In Sharp mode, they are unconnected. 



XY_RENDER <State> 

<state> : = {sharp, SMOOTH} 



XY_RENDER? 



XY_RENDER <State> 

The following sets the rendering to sharp: 

CMDS="XY_RENDER SHARP"; CALL 
IBWRT (SCOPE%, CMOS) 
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DISPLAY 

DESCRIPTION 

COMMAND SYNTAX 

QUERY SYNTAX 
RESPONSE EORMAT 
EXAMPLE (GPIB) 

RELATED COMMANDS 



XY_SATURATION, XYSA 

Command/ Query 



The XY_SATURATiON command sets the level at which the color 
spectrum of the persistence display is saturated in XY display mode. 
The level is specified in terms of percentage (PCT) of the total 
persistence data map population. A level of 100 PCT corresponds to 
the color spectrum being spread across the entire depth of the XY 
persistence data map. At lower values, the spectrum will saturate 
(brightest value) at the ^ecified percentage value. The PCT is optional. 

The response to the xy_s at ? query indicates the saturation level of 
the XY persistence data map. 



XY_SAturation <value> 

<value> : = 0 to 100 PCT 



NOTE; The suTBx PCT is optional. 






XY_SAturation? 



XY_SAturation <value> 



The following sets the saturation level of the XY persistence data map 
at 60 % — 60 % of the data points will be displayed with the color 
spectrum, with the remaining 40 % saturated in dre bri^test color: 

CMDS="XYSA 60": CALL IBWRT ( SCOPE% , CMD$ ) 



PERSIST_SAT 
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GPIBPmgram Examples 



Exanq)lel 

USE THE INTERACTIVE GPIB PROGRAM TBIC" 

This example assumes the use of an IBM PC or compatible equipped with a National Instruments G PIB 
interface card. The G PIB driver is left in default state so that the device name "dev4" corresponds to the G PIB 
address 4, the oscilloscope address. All text is entered by the user. 

IBIC<cr> 

program announces itself 

; ibfind<CR> 

enter board/ device name: dev4 <CR> 

dev4: ibwrt<CR> 

enter string: "tdiv?"<CR> 

[0100]( cmpl ) 
count: 5 

dev4: ibrd<CR> 
enter byte count: io<CR> 

[0100] ( cmpl ) 
count: 10 

54 44 49 56 20 35 30 45 TDIV 50E 

2D 39 - 9 

dev4: ibwrt<CR> 
enterstring: "cl : cpl?"<CR> 

[0100] ( cmpl ) 
count: 7 

dev4: ibrd<CR> 
enter byte count: 2 0<CR> 

[2100K end cmpl) 
count: 11 

43 31 3A 43 50 4C 20 44 C 1 : C P L D 

35 30 OA 5 0 z 

dev4: q<CR> to quit the program. 
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Exanq)le2 

USE THE GPIB PROGRAM FOR IBM PC (HIGH-LEVEL FUNCTION CALLS) 

The following BASICA program allows full interactive control of the oscilloscope using an IBM PC as G PIB 
controller. As in Example 1, it is assumed that the controller is equipped with a National Instruments G PIB 
interface card. All commands can be used following this example simply by entering the text string of the 
command. For example, "c i : VD i v 5 0 mv", without the quotation marks. The program automatically 
displays the information sent back by the oscilloscope in response to queries. 

In addition, a few utilities have been provided for convenience. The commands ST and RC enable waveform 
data to be stored on, or retrieved from, a disk if the correct drive and file names are provided. The command 
LG returns the oscilloscope to local mode. Responses sent back by the oscilloscope are interpreted as character 
strings and are thus limit^ to a maximum of 255 characters. 

1-99<DECL.BAS> 

lOOCLS 

llOPRINT "Control of the 9300 via GPIB and IBM PC" 

1I5PRINT "" 

120PRINT "Options : EX to exitLC local mode" 

125PRINT "ST store dataRC recall data" 

130 PRINT "" 

140LINE INPUT "GPIB-address of oscilloscope (1...16)? :",ADDR$ 

145DEV$ = "DEV" + ADDR$ 

150CALL IBFIND (DEV$, SCOPE%) 

155IF SCOPE% < 0 THEN GOTO 830 

160TMO% = 10 'timeout = 300 msec (rather than default 10 sec) 

165CALL IBTMO (SCOPE%, TMO%) 

170 ' 

200LOOP% = 1 
205WHILE LOOP% 

210LINE INPUT "Enter command (EX — > Exit) : ",CMD$ 



220 IF 


CMD$ = 


"ex" 


OR 


CMD$ = 


" EX " 


THEN 


LOOP% 


= 0 


: GOTO 


310 


230 IF 


CMD$ = 


"st" 


OR 


CMD$ = 


"ST" 


THEN 


GOSUB 


600 


: GOTO 


300 


240 IF 


CMD$ = 


"rc" 


OR 


CMD$ = 


" RC " 


THEN 


GOSUB 


700 


: GOTO 


300 


250 IF 


CMD$ = 


"Ic" 


OR 


CMD$ = 


"LC" 


THEN 


GOSUB 


400 


: GOTO 


300 
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260 IF CMD$ = "" THEN GOTO 300 
270 CALL IBWRT (SCOPE%, CMD$) 

275 IF IBSTA% < 0 THEN GOTO 840 

280GOSUB 500 

300 WEND 

310GOSUB 400 

32 0 END 

400 ' 

405 ' SUBROUTINE LOCAL_MODE 
410 ' 

420CALL IBLOC (SCOPE%) 

425PRINT "" 

430 RETURN 
500 ' 

505 ' SUBROUTINE GET_DATA 

510 'If there are no data to read, simply wait until timeout occurs 
515 ' 

520CALL IBRD (SCOPE%, RD$) 

5251 = IBCNT% ' IBCNT% is the number of characters read 
530FOR J = 1 TO I 
535PRINT MID$ (RD$, J, 1) ; 

540NEXT J 
545PRINT "" 

550 RETURN 
600 ' 

605 ' SUBROUTINE STORE_DATA 
610 ' 

615RD1$=SPACE$ (3) 

620LINE INPUT "Specify trace (TA . . . TD, Ml . . ,M4 , Cl . . . C4 ) : ",TRACE$ 

625LINE INPUT "Enter filename : ",FILE$ 

630CMD$="WFSU NP, 0, SP, 0, FP, 0, SN, 0; CHDR SHORT" 
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64 0 CALL IBWRT (SCOPE%, CMD$) 

645CMD$=TRACE$+" :WF?" 

650CALL IBWRT (SCOPE%, CMD$) 

660CALL IBRD (SCOPE%, RD1$ ) 'Discard first 3 chars of response 

665CALL IBRDF (SCOPE%, FILE$) 

670 IF IBSTA% < 0 THEN GOTO 840 
675PRINT "" 

680 RETURN 
700 ' 

705 ' SUBROUTINE RECALL_DATA 
710 ' 

715LINE INPUT "Specify target memory (M1...M4) :",MEM$ 

720LINE INPUT "Enter filename : ", FILES 

730CMD$=MEM$+" : " 

735CALL IBWRT (SCOPE%, CMD$) 

740CALL IBWRTF (SCOPE%, FILES) 

745IF IBSTA% < 0 THEN GOTO 840 
750 PRINT "" 

755RETURN 
800 ' 

810 'ERROR HANDLER 
820 ' 

830PRINT "IBFIND ERROR" 

835END 

84 0 PRINT "GPIB ERROR — IBERR: " ; IBERR% ; " IBSTA : " ; HEXS ( IBSTA% ) 

END 



258 



I SSUE D : January 2002 



LTXXX-RCM-E Rev B 




GPIBPwgmmExan^des 



NOTE: 

It is assumed that the National Instruments GPIB driver GPIB. COM is in its deMdt state. This 
means that the interface board can be lefened to by its symbolic name 'GPIBff and that devices 
on dw GPIB with addresses 1 to 16 can be called by Ok symbolic name BEVT to 'DEV16'. 

Lines 1-99 are a copy of the Ble DECL.BAS siqrplied by National Instruments. The Orst six lines 
are required for the initialization of the GPIB handler. DECL.BAS requires access to theBle 
BIB.M during the GPIB initializ ation. BIB.M is one of the Bles supplied 1^ National 
Instruments, and must exist in the directory currently in use. 

The Orst two lines of DECL.BAS each contain a string "XXXXX" which must be replaced by the 
rrumber of bytes which determine the maximum worispaceforBASICA (computed by 
subtracting the size of BLB.MOvm the currently available space in BASICA). Ear example, if the 
size of BLB.M is 1200 bytes and whm BASICA is loaded it n^rts "60200 l^ies Bee", "XXXXX" 
would be replied by the value 59000 or less. 

The defyult timeout of 10 seconds is modiOed to 300ms during the execution of this program 
However, the de^ult value of the GPIB handler remains unchanged. Whenever a remote 
command is entered by the user, the program sends it to the instrument with theOinction call 
lEWRT. AOerwards, it always executes an IBRD call, regardless of whether or not a response is 
^greeted. If a response is remived it is imrrKdiatHy displayed. If th&e is no response, the 
program waits until time-out and then asks for the next command. I 
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Exanq)le3 



USE GPIB PROGRAM FOR IBM PC (LOW-LEVEL FUNCTION CALLS) 

This example has the same function as Example 2, but is written with low-level function calls. The program 
assumes that the controller (board) and oscilloscope (device) are at addresses 0 and 4, re^ectively, and the 
decimal addresses are: 





Listener Address 


Talker Address 


Controller 


32(ASCII <space>) 


64 (ASCII©) 


Device 


32-f4=36 (ASCII® 


64-f4=68 (ASCII D) 



1-99<DECL.BAS> 

lOOCLS 

llOPRINT "Control of the 9300 (address 4) via GPIB and IBM PC" 
115PRINT PRINT "Options : EX to exit LC local mode" 

120PRINT " ST store data RC recall data": PRINT"" 

125LOOP=l 

130CMD1$ = "?_0$" 'Unlisten, Untalk, Board talker. Device listener 
135CMD2$ = " ?_ D" 'Unlisten, Untalk, Board listener. Device talker 
140BDNAME$= "GPIBO"; CALL IBFIND (BDNAME$ , BRD0% ) 

145IF BRD0% < 0 THEN GOTO 420 

150CALL IBSIC (BRD0%) : IF IBSTA% < 0 THEN GOTO 425 
155WHILE LOOP 

160LINE INPUT "Enter command (EX — > Exit) : ",CMD$ 

165V% = 1: CALL IBSRE (BRD0%, V%) 



170 IF 


CMD$ = 


"ex" 


OR 


CMD$ 


= "EX" 


THEN 


LOOP = 


FALSE: GOTO 205 


175 IF 


CMD$ = 


"st" 


OR 


CMD$ 


= "ST" 


THEN 


GOSUB 


285: 


GOTO 200 


180 IF 


CMD$ = 


"rc" 


OR 


CMD$ 


= "RC" 


THEN 


GOSUB 


365: 


GOTO 200 


185 IF 


CMD$ = 


"Ic" 


OR 


CMD$ 


= "LC" 


THEN 


GOSUB 


240 


: GOTO 200 


190 IF 


CMD$ = 


" " THEN 


GOTO 


200 











195CALL IBCMD (BRD0%, CMD1$) : CALL IBWRT (BRD0% , CMD$ ) : GOSUB 270 
2 00 WEND 
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205CALL IBSIC (BRDO%) : V%=0 : CALL IBSRE (BRDO% , V% ) 

210CALL IBSIC (BRDO%) 

215END 
220 ' 

230 'LOCAL MODE 
235 ' 

240V% = 0: CALL IBSRE (BRD0%, V%) : PRINT "" 

245RETURN 
250 ' 

260 ' SUBROUTINE GET_DATA 
265 ' 

270CALL IBCMD (BRD0%, CMD2$) : CALL IBRD (BRD0%, RD$ ) : I=IBCNT% 

275FOR J=1 TO I: PRINT MID$ (RD$ , J, 1 ) ; : NEXT J: PRINT "" 

2 80 RETURN 
285 ' 

290 ' SUBROUTINE STORE_DATA 
295 ' 

300RD1$=SPACE$ (3) 

305LINE INPUT "Specify trace (TA . . . TD, Ml . . ,M4 , Cl . . . C4 ) : ",TRACE$ 

310LINE INPUT "Enter filename : ",FILE$ 

315CALL IBCMD (BRD0%, CMD1$) 

320CMD$="WFSU NP, 0, SP, 0, FP, 0, SN, 0; CHDR SHORT" 

321CALL IBWRT (BRD0%, CMD$) 

325CMD$=TRACE$+" :WF?" : CALL IBWRT (BRD0%, CMD$ ) 

330CALL IBCMD (BRD0%, CMD2$) : CALL IBRD (BRD0%, RD1$ ) 

335CALL IBRDF (BRD0%, FILE$) 

340 IF IBSTA% < 0 THEN GOTO 430 
345PRINT "" 

350 RETURN 
355 ' 

360 ' SUBROUTINE RECALL_DATA 
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365 ' 

370LINE INPUT "Specify target memory (M1...M4) : " , MEM$ 

375LINE INPUT "Enter filename : ", FILES 
380CALL IBCMD (BRD0%, CMD1$) 

385CMD$=MEM$+" : " : CALL IBWRT (BRD0%, CMD$) 

390CALL IBWRTF (BRD0%, FILES) 

395IF IBSTA% < 0 THEN GOTO 430 
4 00 PRINT "" 

405RETURN 
410 ' 

415 'ERROR HANDLER 
420 ' 

425PRINT "IBFIND ERROR": STOP 

430 PRINT "GPIB ERROR — IBERR : " ; IBERR% ; " IBSTA : " ; HEXS ( IBSTA% ) 

435STOP 

44 0 END 



NOTE: The Template also describes an anay^ named DUAL This is 
simply a w^toallowyou to use the inspect? query to exami iie 
the tun data arrays together'. — 






262 



I SSUE D : January 2002 



LTXXX-RCM-E Rev B 





Appendix II 



Wa^ormTenapMe 



W^K/efomi Ten^late 

This template is the oscilloscope's response to a TMPL? query: 

/OO 

000000 LECROY_2_3: TEMPLATE 

8 66 111 

r 

; Explanation of the formats of waveforms and their descriptors on the 
; LeCroy Digital Oscilloscopes, 

; Software Release 8.1.0, 98/09/29. 

r 

; A descriptor and/or a waveform consists of one or several logical data blocks 
; whose formats are explained below. 

; Usually, complete waveforms are read: at the minimum they consist of 
; the basic descriptor block WAVEDESC 

; a data array block. 

; Some more complex waveforms, e.g. Extrema data or the results of a Fourier 
; transform, may contain several data array blocks. 

; When there are more blocks, they are in the following sequence: 

; the basic descriptor block WAVEDESC 

; the history text descriptor block USERTEXT (may or may not be present) 

; the time array block (for RIS and sequence acquisitions only) 

; data array block 

; auxiliary or second data array block 

r 

; In the following explanation, every element of a block is described by a 
; single line in the form 

r 

; <byte position> <variable name> : <variable type> ; <comment> 

r 

; where 

/ 

; <byte position> = position in bytes (decimal offset) of the variable, 

; relative to the beginning of the block. 

/ 

; <variable name> = name of the variable. 

/ 

; <variable type> = string up to 16-character name 

; terminated with a null byte 

; byte 08-bit signed data value 

; word 16-bit signed data value 

; long 32-bit signed data value 

; float 32-bit IEEE floating point value 

; with the format shown below 
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double 



enum 



time_stamp 



data 



text 

unit_def inition 



WAVEDESC: BLOCK 



31 30 . . 23 22 ... 0 bit position 

s exponent fraction 

where 

s = sign of the fraction 

exponent = 8 bit exponent e 

fraction = 23 bit fraction f 

and the final value is 

(-l)**s * 2**(e-127) * l.f 

64-bit IEEE floating point value 

with the format shown below 

63 62 . . 52 51 ... 0 bit position 

s exponent fraction 

where 

s = sign of the fraction 
exponent = 11 bit exponent e 
fraction = 52 bit fraction f 
and the final value is 
(-l)**s * 2**(e-1023) * l.f 
enumerated value in the range 0 to N 
represented as a 16-bit data value. 

The list of values follows immediately. 

The integer is preceded by an _. 
double precision floating point number, 
for the number of seconds and some bytes 
for minutes, hours, days, months and year. 



double 

byte 

byte 

byte 

byte 

word 

word 



seconds 

minutes 

hours 

days 

months 

year 

unused 



(0 to 
(0 to 
(0 
(1 
(1 
(0 



59) 

59) 
to 23) 
to 31) 
to 12) 
to 16000) 



There are 16 bytes in a time field, 
byte, word or float, depending on the 
read-out mode reflected by the WAVEDESC 
variable COMM_TYPE, modifiable via the 
remote command COMM_FORMAT . 
arbitrary length text string 
(maximum 160) 

a unit definition consists of a 48 character 
ASCII string terminated with a null byte 
for the unit name. 



; Explanation of the wave descriptor block WAVEDESC; 
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< 0> DESCRIPTOR_NAME : string ; the first 8 chars are always WAVEDESC 

r 

< 16> TEMPLATE_NAME : string 

f 

< 32> COMM_TYPE : enum ; chosen by remote command COMM_FORMAT 

_0 byte 

_1 word 

endenum 

f 

< 34 > COMM_ORDER: enum 

_0 HIFIRST 

_1 LOFIRST 

endenum 



; The following variables of this basic wave descriptor block specify 
; the block lengths of all blocks of which the entire waveform (as it is 
; currently being read) is composed. If a block length is zero, this 
; block is (currently) not present. 

r 

; Blocks and arrays that are present will be found in the same order 
; as their descriptions below. 

r 

; BLOCKS : 

/ 

< 36> WAVE_DESCRIPTOR: long ; length in bytes of block WAVEDESC 

< 40> USER_TEXT: long ; length in bytes of block USERTEXT 

< 44> RES_DESC1: long ; 

r 

; ARRAYS : 

r 

< 48> TRIGTIME_ARRAY: long ; length in bytes of TRIGTIME array 

r 

< 52> RIS_TIME_ARRAY : long ; length in bytes of RIS_TIME array 

r 

< 56> RES_ARRAY1 : long ; an expansion entry is reserved 

r 

< 60> WAVE_ARRAY_1 : long ; length in bytes of 1st simple 

; data array. In transmitted waveform, 

; represent the number of transmitted 
; bytes in accordance with the NP 
; parameter of the WFSU remote command 
; and the used format (see COMM_TYPE) . 



< 


64> 


WAVE_ARRAY_ 


_2 : long 


; length in bytes of 2nd simple 










; data array 


r 

< 


68> 


RES_ARRAY2 : 


: long 




< 


72> 


RES_ARRAY3 : 


: long 


; 2 expansion entries are reserved 
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; The following variables identify the instrument 



< 76> 


INSTRUMENT_ 


_NAME : string 




r 

< 92> 


INSTRUMENT_ 


.NUMBER: long 




r 

< 96> 


TRACE_LABEL: string 


; identifies the waveform 


f 

<112> 


RESERVEDl : 


word 




<114> 


RESERVED2 : 


word 


; 2 expansion entries 



; The following variables describe the waveform and the time at 



; which 


the waveform was generated. 




f 

<116> 


WAVE_ARRAY_COUNT 


: long 


; number of data points in the data 
; array. If there are two data 
; arrays (FFT or Extrema) , this number 
; applies to each array separately. 


r 

<120> 


PNTS_PER_SCREEN : 


long 


; nominal number of data points 
; on the screen 


/ 

<124> 


FIRST_VALID_PNT : 


long 


; count of number of points to skip 
; before first good point 
; FIRST_VALID_POINT = 0 
; for normal waveforms. 


r 

<128> 


LAST_VALID_PNT : 


long 


; index of last good data point 
; in record before padding (blanking) 

; was started. 

; LAST_VALID_POINT = WAVE_ARRAY_COUNT-l 
; except for aborted sequence 
; and rollmode acquisitions 


/ 

<132> 


FIRST_POINT: long 


; for input and output, indicates 
; the offset relative to the 
; beginning of the trace buffer. 

; Value is the same as the FP parameter 
; of the WFSU remote command. 


r 

<136> 


SPARS ING_FACTOR: 


long 


; for input and output, indicates 
; the sparsing into the transmitted 
; data block. 

; Value is the same as the SP parameter 
; of the WFSU remote command. 


/ 

<140> 


SEGMENT_INDEX: long 


; for input and output, indicates the 
; index of the transmitted segment. 

; Value is the same as the SN parameter 
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<144> SUBARRAY_COUNT : long 

/ 

<148> SWEEP S_PER_ACQ: long 

r 

<152> POINTS_PER_PAIR: word 

always 

and 

for 

r 

<154> PAIR_OFFSET: word 

the 

r 

<156> VERTICAL_GAIN: float 

r 

<160> VERTICAL_OFFSET : float 

VERTICAL_OFFSET 

r 

<164> MAX_VALUE: float 

/ 

<168> MIN_VALUE: float 

/ 

<172> NOMINAL_BITS : word 

r 

<174> NOM_SUBARRAY_COUNT : word 

r 

<176> HORIZ_INTERVAL : float 

r 

<180> HORIZ_OFFSET : double 



; of the WFSU remote command. 

; for Sequence, acquired segment count, 
; between 0 and NOM_SUBARRAY_COUNT 

; for Average or Extrema, 

; number of sweeps accumulated 
; else 1 

; for Peak Dectect waveforms (which 

; include data points in DATA_ARRAY_1 

; min/max pairs in DATA_ARRAY_2 ) . 

; Value is the number of data points 

; each min/max pair. 

; for Peak Dectect waveforms only 
; Value is the number of data points by 
; which the first min/max pair in 
; DATA_ARRAY_2 is offset relative to 

; first data value in DATA_ARRAY_1 . 



; to get floating values from raw data 
; VERTICAL_GAIN * data - 

; maximum allowed value. It corresponds 
; to the upper edge of the grid. 

; minimum allowed value. It corresponds 
; to the lower edge of the grid. 

; a measure of the intrinsic precision 
; of the observation: ADC data is 8 bit 
; averaged data is 10-12 bit, etc. 

; for Sequence, nominal segment count 
; else 1 

; sampling interval for time domain 
; waveforms 

; trigger offset for the first sweep of 
; the trigger, seconds between the 
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; trigger and the first data point 

PIXEL_OFFSET : double ; needed to know how to display the 

; waveform 

VERTUNIT: unit_definition ; units of the vertical axis 

HORUNIT : unit_definition ; units of the horizontal axis 

HORIZ_UNCERTAINTY : float ; uncertainty from one acquisition to the 

; next, of the horizontal offset in seconds 

TRIGGER_TIME : time_stamp ; time of the trigger 



ACQ_DURATION: float 



; duration of the acquisition (in sec) 
; in multi-trigger waveforms. 

; (e.g. sequence, RIS, or averaging) 



RECORD_TYPE : enum 
_0 single_sweep 

_1 interleaved 

_2 histogram 

_3 graph 

_4 f ilter_coef f icient 

_5 complex 

_6 extrema 

_7 sequence_obsolete 

_8 centered_RIS 

_9 peak_detect 

endenum 

PROCESSING_DONE : enum 
_0 no_processing 

_1 fir_filter 

_2 interpolated 

_3 sparsed 

_4 autoscaled 

_5 no_result 

_6 rolling 

_7 cumulative 

endenum 



RESERVED5: word 



expansion entry 



RIS_SWEEPS: word 



; for RIS, the number of sweeps 
; else 1 



; The following variables describe the basic acquisition 
; conditions used when the waveform was acquired 
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< 324 > 



TIMEBASE: enum 


_0 


l_ps/div 


_1 


2_ps/div 


_2 


5_ps/div 


_3 


10_ps/ div 


_4 


20_ps/ div 


_5 


50_ps/ div 


_6 


10 0_ps/div 


_7 


2 0 0_ps/div 


_8 


50 0_ps/div 


_9 


l_ns/div 


_10 


2_ns/div 


_11 


5_ns/div 


_12 


10_ns/ div 


_13 


20_ns/ div 


_14 


50_ns/ div 


_15 


100_ns/div 


_16 


200_ns/div 


_17 


50 0_ns/div 


_18 


l_us/div 


_19 


2_us/div 


_2 0 


5_us/div 


_21 


10_us/ div 


_22 


20_us/ div 


_2 3 


50_us/ div 


_2 4 


10 0_us/div 


_2 5 


2 0 0_us/div 


_2 6 


50 0_us/div 


_2 7 


l_ms/div 


_2 8 


2_ms/div 


_2 9 


5_ms/div 


_30 


10_ms/ div 


_31 


20_ms/ div 


_32 


50_ms/ div 


_33 


100_ms/div 


_34 


200_ms/div 


_35 


50 0_ms/div 


_36 


l_s/ div 


_37 


2_s/ div 


_38 


5_s/ div 


_39 


10_s/div 


_4 0 


20_s/div 


_41 


50_s/div 


_42 


100_s/ div 


_4 3 


200_s/ div 


_4 4 


500_s/ div 


_4 5 


l_ks/div 


_4 6 


2_ks/div 


_4 7 


5_ks/div 


_100 


EXTERNAL 
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endenum 



<326> 



r 

<328> 

r 

<332> 



<334> 



<336> 



VERT_COUPLING: enum 
_0 DC_50_Ohms 

_1 ground 

_2 DC_lMOhm 

_3 ground 

_4 AC,_lMOhm 

endenum 



PROBE_ATT: float 

FIXED_VERT_GAIN: enum 

_0 l_uV/div 

_1 2_uV/div 

_2 5_uV/div 

_3 10_uV/div 

_4 20_uV/div 

_5 50_uV/div 

_6 100_uV/div 

_7 200_uV/div 

_8 500_uV/div 

_9 l_mV/div 

_10 2_mV/div 

_11 5_mV/div 

_12 10_mV/div 

_13 20_mV/div 

_14 50_mV/div 

_15 100_mV/div 

_16 200_mV/div 

_17 500_mV/div 

_18 l_V/div 

_19 2_V/div 

_20 5_V/div 

_21 10_V/div 

_22 20_V/div 

_23 50_V/div 

_24 100_V/div 

_25 200_V/div 

_26 500_V/div 

_27 l_kV/div 

endenum 



BANDWIDTH_LIMIT : enum 
_0 off 

_1 on 

endenum 



VERTICAL_VERNIER: float 
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<340> ACQ_VERT_OFFSET : float 

r 

<344> WAVE_SOURCE: enum 

_0 CHANNEL_1 

_1 CHANNEL_2 

_2 CHANNEL_3 

_3 CHANNEL_4 

_9 UNKNOWN 

endenum 

f 

/OO ENDBLOCK 



USERTEXT: BLOCK 

r 

; Explanation of the descriptor block USERTEXT at most 160 bytes long. 

/ 

f 

< 0> TEXT: text ; a list of ASCII characters 

r 

zoo ENDBLOCK 



TRIGTIME: ARRAY 

r 

; Explanation of the trigger time array TRIGTIME. 

; This optional time array is only present with SEQNCE waveforms. 

; The following data block is repeated for each segment which makes up 
; the acquired sequence record. 



A 

O 

V 


TRIGGER_TIME : 


double 


; for sequence acquisitions, 
; time in seconds from first 
; trigger to this one 


t 

< 8> 


TRIGGER_OFFSET 


: double 


; the trigger offset is in seconds 
; from trigger to zeroth data point 



ZOO ENDARRAY 



RISTIME: ARRAY 

r 

; Explanation of the random-interleaved-sampling (RTS) time array RISTIME. 
; This optional time array is only present with RTS waveforms. 

; This data block is repeated for each sweep which makes up the RTS record 

r 

< 0> RIS_OFFSET: double ; seconds from trigger to zeroth 
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; point of segment 



/ 0 0 ENDARRAY 



DATA_ARRAY_1 : ARRAY 

r 

; Explanation of the data array DATA_ARRAY_1 . 

; This main data array is always present. It is the only data array for 
; most waveforms. 

; The data item is repeated for each acquired or computed data point 
; of the first data array of any waveform. 

/ 

< 0> MEASUREMENT : data ; the actual format of a data is 

; given in the WAVEDESC descriptor 
; by the COMM_TYPE variable. 

r 

/ 0 0 ENDARRAY 



DATA_ARRAY_2 : ARRAY 

r 

; Explanation of the data array DATA_ARRAY_2 . 

; This is an optional secondary data array for special types of waveforms: 

; Complex EFT imaginary part (real part in DATA_ARRAY_1 ) 

; Extrema floor trace (roof trace in DATA_ARRAY_1 ) 

; Peak Detect min/max pairs (data values in DATA_ARRAY_1 ) 

; In the first 2 cases, there is exactly one data item in DATA_ARRAY_2 for 
; each data item in DATA_ARRAY_1 . 

; In Peak Detect waveforms, there may be fewer data values in DATA_ARRAY_2 , 
; as described by the variable POINTS_PER_PAIR. 

r 

< 0> MEASUREMENT : data ; the actual format of a data is 

; given in the WAVEDESC descriptor 
; by the COMM_TYPE variable. 

/ 

/ 0 0 ENDARRAY 



SIMPLE: ARRAY 

r 

; Explanation of the data array SIMPLE. 

; This data array is identical to DATA_ARRAY_1 . SIMPLE is an accepted 
; alias name for DATA_ARRAY_1 . 

f 

< 0> MEASUREMENT : data ; the actual format of a data is 

; given in the WAVEDESC descriptor 
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/ 0 0 ENDARRAY 



DUAL : ARRAY 



by the COMM_TYPE variable. 



; Explanation of the DUAL array. 

; This data array is identical to DATA_ARRAY_1 , followed by DATA_ARRAY_2 . 
; DUAL is an accepted alias name for the combined arrays DATA_ARRAY_1 and 
; DATA_ARRAY_2 (e.g. real and imaginary parts of an EFT) . 



• A 

O 

V 


MEASUREMENT_1 : 


data 


; data 


in DATA_ARRAY_1 


r 

< o> 

r 

zoo 

r 


MEASUREMENT_2 : 
ENDARRAY 


data 


; data 


in DATA_ARRAY_2 


r 

000000 


ENDTEMPLATE 
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A 

Addresses, 13 

ALL_ STATUS?, ALST?, Query, 63 

ARM ACQUISITION, ARM, Command, 64 

ASCII 

waveform storage, 11 

ATTENUATION, ATTN, Command/ Query, 65 
AUTOCALIBRATE, ACAL, Command/ Query, 
66 

AUTO SCROLL, ASCR, Command/ Query, 67 
AUTO SETUP, ASET, Command, 68 

B 

BAND WIDTH LIMIT, BWL, Command/ Query, 
69 

BASICA, 15, 37 
Binary blocks, 39 
Block Data, 10 
Buffers, 14 

BUZZER, BUZZ, Command, 71 

c 

CAL?, Query, 72 

CAL OUTPUT, COUP, Command/ Query, 73 
CALL HOST, CHST, Command/ Query, 74 
Character data, 9 

CLEAR_ MEMORY, CLM, Command, 75 
CLEAR_ SWEEPS, CLSW, Command, 76 
*CLS, Command, 77 

CMR (Command Error Status Register), 47, 49 
CMR?, Query, 78 

COLOR, COLR, Command/ Query, 80 
CO LOR_ SCHEME, CSCH, Command/ Query, 

83 

Colors 

list of colors and their short form names, 81 
COMM EORMAT, CEMT, Command/ Query, 84 



COMM HEADER, CHDR, Command/ Query, 

86 

COMM HELP, CHLP, Command/ Query, 87 
COMM HELP LOG?, CHL?, Query, 88 
COMMORDER, CORD, Command/ Query, 89 
COMM RS232, CORS, Command/ Query, 91 
Commands and Queries, 6 
How they are described, 52 
Notation, 52 
Overview, 52 
Configuring 
Printing, 22 
Continuous Poking, 19 
Controller Timeout, 7, 14, 18, 20, 258 
COUPLING, CPL, Command/ Query, 94 
CURSOR_ MEASURE, CRMS, Command/ Query, 
95 

CURSOR SET, CRST, Command/ Query, 98 
CURSOR_ VALUE?, CRVA?, Query, 100 

D 

Data 

Arrays, 35 
Eormatting, 37, 51 
HEX mode, 29, 31, 51 
Horizontal position, 40 
Interpretation, 37, 39 
Sparsmg, 51 
Values, 36, 39 
Vertical reading, 39 

DATAPOINTS, DPNT, Command/ Query, 102 
DATE, Command/ Query, 103 
D D R (D evice D ependent Error Status Register), 

50 

DDR?, Query, 104 

DEEINE, DEE, Command/ Query, 106 
DELETE EILE, DELE, Command, 112 
Descriptor 
Block, 35 
Values, 36, 39 

D evice D ependent Error Status Register, see D D R 



LTXXX-RCM-E Rev B 



I SSUE D : January 2002 



275 




Index 



DIRECTORY, DIR, Command/ Query, 113 
DISPLAY, DISP, Command/ Query, 115 
DOTJOIN, DTJN, Command/ Query, 116 
DUALArr^, 35 

DUAL ZOOM, DZOM, Command/ Query, 117 

E 

ENABLE KEY, Command/ Query, 118 
Error Messages, 6 

ESE (Standard Event Status Enable Register), 19, 
47,49 

*ESE, Command/ Query, 119 

ESR (Standard Event Status Register), 19, 47, 49 

*ESR?, Query, 120 

Execution Error Status Register, see EXR 
EXR (Execution Error Status Register), 47, 50 
EXR?, Query, 123 
External Monitor port, 5, 6 

F 

EAT CURSOR, EATC, Command/ Query, 125 
EILENAME, ELNM, Command/ Query, 126 
EIND_CTR_ RANGE, ECR, Command, 127 
EORMAT CARD, ECRD, Command/ Query, 128 
EORMATELOPPY, EELP, Command/ Query, 
130 

EORMATHDD, EHDD, Command/ Query, 132 
EULL_ SCREEN, ESCR, Command/ Query, 134 
EUNCTION RESET, ERST, Command, 135 

G 

GLOBAL BWL, GBWL, Command/ Query, 136 
GPIB 

Addresses, 13 
ATN (ATteNtion), 14 
Datelines, 13 
DCL (Device CLear), 14 
EOI (End Or Identify), 6, 14 
GET (Group Execute Trigger), 15, 18 
GTL (Go To Local), 15, 18 
Handshake lines, 14 
Hard copies, 22 
Hardcopy, 22, 23 

276 



Hardware configuration, 15 

IEEE 488.1, 14 

IEEE 488.2, 14 

lEC (InterEace Clear), 14, 15 

INE (Internal State Change Enable Register), 19 

INR (Internal State Change Status Register), 19 

Listener address, 23 

LLO (Local LOckout), 15 

MLA (Listen address), 13 

MTA (Talker address), 13 

Polling, 19 

port, 5 

PRE (Parallel Poll Enable Register), 21 
Printing, 23 

Program for IBM PC, 256, 258, 256, 258 
Programming service requests, 18 
Programming transfers, 15 
REN (Remote ENable), 14, 15 
RQ S (ReQuest for Service), 20 
SDC (Selected Device CLear), 14, 18 
Signals, 13 

Software configuration, 15 

SRE (Service Request Enable Register), 18 

SRQ (Service Request), 18, 19 

SRQ (Service ReQuest), 14 

Standard, 6 

Structure, 13 

Talker address, 23 

Transfers, 15 

UNL (Universal unlisten), 13, 22, 23 
UNT (Universal untalk), 13, 22, 23 
GRID, Command/ Query, 137 

H 

Hard copies, see G PIB 

HARD CO PY_ SETUP, HCSU, 138 

HARDCOPY TRANSMIT, HCTR, Command, 

141 

Header, 7 
Header Path, 7 
Help Messages, 6 

HO R_ MAGNIFY, HMAG, Command/ Query, 

142 

HO R_ POSITION, HPOS, Command/ Query, 143 
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I 

*IDN?, Query, 145 

IEEE 488.1, 5 

IEEE 488.2, 6, 47, 49 

IEEE Standards, see GPIB 

INE (Internal State Change Enable Register), 19, 

49, 50 

INE (INtemal State Change Enable Register), 47 

INE, Command/ Query, 146 

INR (Internal State Change Status Register, 19 

INR (Internal State Change Status Register), 19, 50 

INR?, Query, 147 

INSPECT? Queries, 36 

INSPECT?, INSP?, Query, 149 

INTENSITY, INTS, Command/ Query, 151 

Interface Capabilities, 13 

Interface messages, 13 

INTERLEAVED, ILVD, Command/ Query, 152 
Internal State Change Enable Register, see INE 
Internal State Change Status Register, see INR 
1ST PoUing, 22, 47, 50 
*IST?, Query, 153 

K 

KEY, Command, 154 

L 

Line Splitting, see RS-232-C 
Logici Data Blocks, 35 
LQGQ, Command/ Query, 155 

M 

MASK, Command/ Query, 156 
Math functions 

CLEAR_ SWEEPS, CLSW, Command, 76 
CLEAR MEMQRY, CLM, Command, 75 
DEEINE, DEE, Command/ Query, 106 
EIND_CTR_ RANGE, ECR, Command, 127 
EUNCTIQN RESET, ERST, Command, 135 
MathCad®, 11 

MEASUREG ATE, MGAT, Command/ Query, 
158 



MEMQRY SIZE, MSIZ, Command/ Query, 159 
MESSAGE, MSG, Command/ Query, 160 
MULTI ZQQM, MZQM, Command/ Query, 161 
Multipliers, 9 

N 

Numeric Data, 9 

O 

QEESET, QEST, Command/ Query, 162 
*QPC, Command/ Query, 163 
*QPT?, Query, 164 

P 

PANEL_ SETUP, PNSU, Command/ Query, 166 
Parallel Poll Enable Register, see PRE 
Parallel Polling, 21 
Parameter measurements, 87 
PARAMETER CLR, PACE, Command, 167 
PARAMETER CUSTQM, PACU, 

Command/ Query, 168 

PARAMETER DELETE, PADL, Command, 

171 

PARAMETER_ STATISTICS?, PAST?, Query, 

172 

PARAMETER_ VALUE?, PAVA?, Query, 173 
PASS EAIL CQNDITIQN, PECQ, 

Command/ Query, 176 
PASS EAIL CQUNTER, PECT, 

Command/ Query, 178 

PASSEAILDQ, PEDQ, Command/ Query, 179 
PASSEAILMASK, PEMS, Command, 181 
PASS_EAIL_ STATUS?, PEST?, Query, 182 
PER CURSQR SET, PECS, Command/ Query, 
183 

PER_CURSQR_ VALUE?, PECV?, Query, 185 
PERSIST, PERS, Command/ Query, 186 
PERSISTCQLQR, PECL, Command/ Query, 
187 

PERSISTLAST, PELT, Command/ Query, 188 
PERSIST SAT, PESA, Command/ Query, 189 
PERSIST_ SETUP, PESU, Command/ Query, 190 
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Polling, 19 
Continuous, 19 
1ST Polling, 22 
Parallel, 21 
Serial, 20 

PRE (Parallel Poll Enable Register), 21, 47, 50 
*PRE, Command/ Query, 191 
PROBECAL?, PRCA?, Query, 192 
PRQBE DEGAUSS?, PRDG?, Query, 193 
PRQBE NAME?, PRNA?, Query, 194 
Program Messages, 6 

Q 

Quotation marks 

their use in command notation, 10 

R 

*RCL, Command, 195 

REAR QUTPUT, RQUT, Command/ Query, 196 
RECALL, REC, Command, 197 
RECALL_ PANEL, RCPN, Command, 198 
Response Messages, 10 
RIS Acguisition Times (RISTIME), 35 
RISTIME, 35, 40 
RQ S (ReQuest for Service), 20 
RS-232-C 
Configuration, 29 
Echo, 29 
Editing, 29 

Handshake control, 29 
Immediate commands, 29 
Line splitting, 30 
Message terminators, 30 
port, 5, 6 

Simulating G PI B Commands, 31 
SRQ (Service ReQuest), 30 
RS-232-C computer cabling, 11 
*RST, Command, 199 

s 

SAMPLE CLQCK, SCLK, Command/ Query, 

200 

*SAV, Command, 201 

278 
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SCREEN DUMP, SCDP, Command/ Query, 202 
SCREEN SAVE, SCSVG, Command/ Query, 203 
SELECT, SEL, Command/ Query, 204 
SEQUENCE, SEQ, Command/ Query, 205 
Serial Polling, 20 

Service Reguest Enable Register, see SRE 

Service Reguest Reporting, 47 

Service requests, 30 

SIMPLE, 35 

SLEEP, Command, 207 

SRE (Service Request Enable Register), 18, 47, 49, 
50 

*SRE, Command/ Query, 208 

SRQ (Service Request), 18, 19, 30, 49 

Standard Event Status Register, see E SR 

Status Byte Register, see STB 

Status Register Reporting, 47 

STB (Status Byte Register), 18, 49 

*STB?, Query, 209 

STQP, Command, 211 

STQRE, STQ, Command, 212 

STQRE PANEL, STPN, Command, 213 

STQRE SETUP, STST, Command/ Query, 214 

STQRE TEMPLATE, STTM, Command, 215 

String Data, 10 

T 

Talker, 22 

TDISP, Command/ Query, 216 
Template, 35, 36, 39, 40, 263 
TEMPLATE?, TMPL?, Query, 217 
Terminators, 6, 30, 39 
TIME DIV, TDIV, Command/ Query, 218 
TRACE, TRA, Command/ Query, 219 
TRACEQPACITY, TQPA, Command/ Query, 
220 

*TRG , Command, 221 

TRIGCQUPLING, TRCP, Command/ Query, 
222 

TRIGDELAY, TRDL, Command/ Query, 223 
TRIGLEVEL, TRLV, Command/ Query, 225 
TRIGMQDE, TRMD, Command/ Query, 226 
TRIGSELECT TRSE, Command/ Query, 227 
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TRIGSLOPE, TRSL, Command/ Query, 230 
TRIG WINDOW, TRWI, Command/ Query, 231 
Trigger Times (TRIGTIME), 35 
TRIGTIME, 35, 40 
*TST?, Query, 232 

u 

URR (User Request Status Register), 50 
URR?, Query, 233 

User Request Status Register, see URR 
USERTEXT, 35 

V 

VERT_ MAGNIFY, VMAG, Command/ Query, 

235 

VERTPQ SITIQ N, VPQ S, Command/ Query, 

236 

VQLTDIV, VDIV, Command/ Query, 237 

w 



Waveform Template, 263 
WAVEFQRM, WE, Command/ Query, 240 
WAVE FQRM_ SETUP, WFSU, 

Command/ Query, 243 

WAVEFQRMTEXT, WETX, Command/ Query, 
245 

X 

XY ASSIGN?, XYAS?, Query, 246 
XYCURSQRQRIGIN, XYCQ, 

Command/ Query, 247 

XY CURSQR SET, XYCS, Command/ Query, 
248 

XY_CURSQR_ VALUE?, XYCV?, Query, 250 
XY DISPLAY, XYDS, Command/ Query, 252 
XYRENDER, Command/ Query, 253 
XY SATURATIQN, XYSA, Command/ Query, 
254 



*WAI, Command, 238 
WAIT, Command, 239 
Warning Messages, 6 
WAVEDESC. see Descriptor 
WAVEFQRM 
Command, 41 
Query, 37, 41 
Tranter optimization, 41 
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